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Disclaimer of all Warranties and Liabilities 

Logo Computer Systems, Inc., makes no warranties, expressed or implied, 
concerning the quality, performance, merchantability or fitness of use for any 
particular purpose of this manual and the software described in this manual. This 
manual and the software described in this manual are sold "as is ", The entire 
risk as to the quality and performance of these goods is with the buyer; if the 
goods shall prove defective following their purchase, the buyer and not the 
manufacturer, distributor or retailer assumes the entire cost of all necessary 
servicing, repair and replacement and any incidental or consequential damages. 
In no event will Logo Computer Systems, Inc. be responsible for direct, indirect, 
incidental or consequential damages relating to the purchase or use of these 
goods, even if Logo Computer Systems, Inc. has been advised of the possibility 
of such damages. Some states do not allow the exclusion or limitation of implied 
warranties or liability for incidental or consequential damages, so the above 
limitation or exclusion may not apply to you. 

Notice 

Logo Computer Systems, Inc. and ATARI, Inc., reserve the right to make any 
improvements and changes in the product described in this manual at any time 
and without notice. 

Copyright and Trademark Notices 

This product and all software and documentation in this package (ROM 
cartridge, Manuals and Reference Guide) are copyrighted under United States 
Copyright laws by Logo Computer Systems, Inc. 


© 1983 Logo Computer Systems, Inc. 


ATARI is a registered trademark of Atari, Inc. (a Warner Communications 
Company), used by permission. 
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Preface 


Th e ATARI Logo Reference Manual should be used for 
reference rather than as a guide for new users. If you’ve 
worked with another version of Logo, this book will help 
familiarize you with ATARI Logo's special features. First 
time Logo users should start with the companion manual 
Introduction to Programming Through Turtle Graphics. 

The ATARI Logo Reference Manual describes Logo primitives, 
simple commands built into the language, and provides 
sample programs. Refer to the Table of Contents for 
organization of the primitives. 

There are two useful sections in the front of this manual. The 
first gives an introduction to Logo grammar. The second 
explains the conventions used to define the primitives. 

There are several ways to use this manual. If you want to know 
what a specific primitive does, look it up in the index. For quick 
reference, look at Appendix G or H or the Reference Guide. If 
you want to find a primitive to perform a particular task, look at 
the chapter headings or index. 

Appendices include: messages that appear on the screen, 
handy procedures, technical information, ASCII Codes, and a 
glossary of ATARI Logo primitives. 

Throughout this manual, orange text is used to represent what 
you type on the computer. Black text is used to represent what 
the computer displays. Words that are inputs to primitives are 
in italics. 


Getting Started 

To use the ATARI Logo Cartridge, you need an ATARI Home 
Computer and a TV set or monitor. If you want to save 
programs, you need an ATARI Disk Drive or ATARI Program 
Recorder. 

For specific questions about the operation of your ATARI 
Home Computer, refer to the computer owner’s guide. You’ll 
find your computer and ATARI Logo easy to operate. To load 
ATARI Logo into your computer: 

1 . With the computer off, turn on your TV set or monitor. If you 
have one, turn on your ATARI Disk Drive and wait for the 
busy light to go off. If you are not using a disk drive, skip to 
step 3. 

2. Insert the ATARI Master Diskette in the disk drive and close 
the disk drive door. You may also use a data diskette if it 
contains DOS (Disk Operating System) files. 

3. Insert the ATARI Logo Cartridge into the console's 
cartridge slot and turn the computer on. 

After a moment you’ll see on the screen: 

(C) 1983 LCSI ALL RIGHTS RESERVED 
WELCOME TO ATARI LOGO. 

?■ 

The ? (question mark) is the prompt symbol. When ? is on the 
screen, you can type something. The I is the cursor. It shows 
where the next character you type will appear. 

The Keyboard 

The ATARI Home Computer keyboard is set up like a 
typewriter. 

Character Keys 

Character keys — A, b, C, 7, $, etc. They include letters of the 
alphabet, numbers and punctuation marks. 
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RETURN 

In Logo, the return key serves a programming function. It 
tells Logo: “Now do what I just typed.” Press the return key 
when you want Logo to obey your instructions. 

SPACE BAR 

The space bar prints an invisible but important character 
called space. Logo uses spaces as word separators. For 
example, Logo would interpret thisisaword as a single word 
and would interpret THIS is A word as four words. 

SHIFT 

Holding down shift, while pressing some character keys, 
changes that particular character key’s meaning in Logo. For 
example, if you hold the shift key down and press ], Logo will 
print ] (close bracket) on the screen. 

The bracket, [ ], symbols are very important in Logo. Do not 
confuse them with parentheses, ( ), which are shift ( and 
SHIFT). 

To make a shift character, always press the shift key first and 
then hold it down while typing the other key. 

CTRL (CONTROL) 

The Ctrl key can change character keys into function keys. 
Press it alone and nothing happens; hold it down and press a 
certain character key, and something happens. These key 
combinations do not always print out on the screen, but Logo 
responds to them. 
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CTRL Arrow Keys 

CTRL <- will move the cursor one space to the left and CTRL -*■ 
will move the cursor one space to the right. 

The arrow keys are useful editing keys. They move the cursor 
in the direction in which they point without affecting the text 
already there. Note: CTRL t and CTRL l only work in the 
ATARI Logo Editor. Once the cursor is positioned, you can 
insert or delete characters. To insert text, simply position the 
cursor and begin typing. 

DELETE BACK S (DELETE BACK SPACE) 

Erases the character to the left of the cursor. 

BREAK 

The break key tells Logo to stop whatever it is doing. It will 
also get you out of the ATARI Logo Editor without executing 
the changes. When you press break, Logo types 

STOPPED ! 

?l 

then, lets you type the next instruction. 

ESC 

The ESC (ESCape) key is used to exit the ATARI Logo Editor. 
This key is discussed, along with other special editing keys, in 
Chapter 5. 

ATARI Key (A) or Reverse Video Key (E) 

If you press the ( A ) or (B ) key and then type a character key, 
the character appears in reverse video on the screen (dark 
character on a light background). You can return to the regular 
display by pressing the key a second time. 
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CAPS LOWR (CAPS) 

When you first turn on your ATARI Home Computer, anything 
you type will appear in all uppercase letters. Press the caps 
lowr key, now only lowercase letters are produced. ATARI 
Logo primitives must all be typed in uppercase letters. 
Therefore, if you accidentally press the caps lowr key, Logo 
will no longer understand your instructions. 

shift caps lowr Combination 

To lock the keyboard in uppercase, simply hold the shift key 
and then press the caps lowr key. 

SYSTEM RESET (RESET) 

Do not use this key once you have booted Logo. You will lose 
everything in memory. 
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Logo Grammar 

The Logo language is made up of building blocks that can be 
put together in a number of ways and obey certain rules. 

These rules are the “grammar” of the language. In order for 
Logo to understand what you want it to do, you must learn to 
give proper instructions by following the guidelines that we 
describe in this section. 

Procedures 

The building blocks of Logo are procedures and inputs to 
procedures. Some procedures Logo always knows because 
they are built into the Logo system. These are called primitives. 
There is a complete list of them in Appendix G. 

For example, if you type 

CT 

the text is cleared from the screen. You haven’t defined CT, but 
Logo already knows what to do. 

There are also procedures, that you define for yourself, using 
the TO or edit commands. There are many examples in both of 
the manuals. 

Here is a procedure definition. 

TO WELCOME 
PRINT "HI 
END 

The first and last lines follow special rules. The first line is called 
the title line. It must always begin with to followed by the name 
of a procedure. The last line must contain only the word end. 

There is an important difference between “defining” a 
procedure and asking Logo to “execute” it. When we ask 
Logo to run a procedure, we say that we have made a 
procedure call. 
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For example, welcome contains a request to run a procedure 
(which happens to be a primitive) print. 

There is another way of asking Logo to make a procedure call. 
The name is typed in when Logo is at top level (indicated by 
the question mark prompt at the left of the screen). We have 
already seen an example with ct. Here is another example. 

WELCOME 

HI 

If you type in a word and Logo cannot find its definition, you 
get an error message. Suppose, for example, you haven’t 
defined a procedure called talk, 
talk 

I DON'T KNOW HOW TO TALK 

Within a procedure definition, you can, of course, make a call 
to a procedure you have previously defined. 

TO COME. AND. GO 
WELCOME 
PRINT "BYE 
END 

COME. AND. GO 

HI 

BYE 

We say that welcome is a subprocedure of come.and.go. 
come. and. go is a superprocedure of welcome. 

Inputs to Procedures 

Some procedures need inputs. For example, 

PRINT "HI 
HI 

The word "hi is the input to print. The quote mark (") tells 
Logo that you mean the word hi as itself, not as the name of 
another procedure. Here is what happens if you don’t include 
the input: 

print 

NOT ENOUGH INPUTS TO PRINT 
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You can use a sentence, instead of a word, for the input to 
print by putting square brackets around it. 

PRINT [HAVE A NICE DAY] 

HAVE A NICE DAY 

The procedures that you define can also have inputs. When a 
procedure you’ve defined is executed, its inputs are put into 
variables. A variable is like a box which has a name, and which 
can hold an object (a word or a list, as in the examples of 
inputs to print before). When you define a procedure with 
which you want to use inputs, you must provide a variable to 
"hold” each input. Their names must be written on the title line 
after the name of the procedure. Each name must have a 
colon in front. For example, 

TO BIGWELCOME : NAME 
PR "HI 
PR : N AME 

PR [HAVE A NICE DAY] 

END 

The title line tells Logo that the procedure bigwelcome has a 
single input whose name is name. The body of the procedure 
contains three calls of the procedure print (PR is the short form 
of print). The second of these uses the input name. Here is an 
example of a request to execute bigwelcome at top level. 

BIGWELCOME "JANE 
HI 

JANE 

HAVE A NICE DAY 

Here, the input to bigwelcome is jane. Logo makes this the 
value of name when it executes the procedure. Thus, print 
:NAME does the same thing (in this case) as print "jane. 

Quotes, Colons, and Brackets 

When you ask Logo to execute a procedure, you must be very 
careful about how you write the inputs. A good rule of thumb is 
that Logo understands every word as a request to run a 
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procedure unless you specifically indicate that it is not. For 
example, 

BIGWELCOME JANE 

I DON'T KNOW HOW TO JANE 

Logo thinks that jane is a procedure. But since Logo can’t find 
its definition, it doesn’t know how to execute it. Here is an 
example where Logo is able to find the definition. 

BIGWELCOME SUM 31 28 

HI 

59 

HAVE A NICE DAY 

sum is a procedure that adds its inputs. It is a primitive, 
therefore Logo knows how to do it even though you haven’t 
written a definition for it. We will have more to say about using 
procedures as inputs in the next section. 

In order to tell Logo that an input is not a request to run a 
procedure, you need to use certain characters in a special 
way. 

A word beginning with a quote (for example, "jane) tells Logo 
that the input is the word itself and nothing else. We call this a 
literal word. Note that numbers are like literal words but don’t 
need to be quoted. 

A word beginning with a colon (for example, :N) tells Logo that 
the word is the name of a variable and that the input is to be 
the value of the variable. 

A sequence of words surrounded by square brackets (for 
example, [have a nice DAY]) indicates that the input is a list. 

The use of these four special characters is illustrated in the 
definition of bigwelcome. 

print "hi tells Logo to display the word HI. 

print :N tells Logo to display whatever is the value of n when 
the procedure is executed. 


print [have A nice day] tells Logo to display the list have a 
nice day. Note that, print leaves out the square brackets in its 
display. If you want to see the brackets, use show. 

The Difference Between Commands and Operations 

There are two kinds of procedures in Logo. Those that output a 
value (like sum) are called operations. Those that do not output 
a value (like print) are called commands. This distinction is so 
important that we indicate whether each primitive is a 
command or an operation. 

One of the main reasons for this distinction is the fact that an 
operation can only be written as an input to a procedure. This 
means that, in every Logo line, the first word must be a 
command. 

We have already seen an example with print sum 31 28. Here 
are some more examples: 

PRINT RANDOM 2 
1 

The output of random 2 is the input to print. The input to 
random is 2. When random 2 is executed, the result is 
communicated to print. 

PRINT SUM 3 2 
5 

The result of computing the procedure SUM with inputs 3 and 2 
is communicated to print. 

PRINT SUM 3 PRODUCT 5 2 
13 

The output of product is the second input to SUM. 

If you try to use a command as an input, this is what happens: 

PRINT FORWARD 25 

FORWARD DIDN'T OUTPUT TO PRINT 

You get the error message because forward is a command. 
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Up to now, we have only considered Logo primitives. 

However, all of the procedures you define yourself are also 
either commands or operations. For example, the procedure 
bigwelcome (defined previously) is a command. The 
procedure flip is an operation. 

TO FLIP 

IF (RANDOM 2) = 0 [OUTPUT "HEADS] C0U-> 

TPUT "TAILS] 

END 

This outputs the word heads if random 2 outputs 0 or the word 
tails if random 2 outputs i. As with primitives, typing only the 
procedure name alone yields an error message. 

FLIP 

I DON'T KNOW WHAT TO DO WITH HEADS 

or 

I DON'T KNOW WHAT TO DO WITH TAILS 

On the other hand, we have 

PRINT FLIP 
HEADS 

or 

TAILS 

Almost all the procedures in the Introduction Manual are 
commands. On the other hand, procedures involving words, 
lists, and numbers are frequently operations. To construct your 
own operations, you will always use the output command. For 
more information, see output in Chapter 6. 

Variables 

The best way to understand variables in Logo is to view them 
as containers with names on the outside and contents inside. 
The colon in front of a word tells Logo to make its contents 
available to the procedure. If you type 

PRINT : JOHN 


f 


c= 

c 

d 

r 

Logo looks for a container named JOHN. If it finds one, it looks 
inside the container and makes whatever it finds available to f 
print, print then displays the contents (value) of JOHN on the 
screen. If it finds nothing, Logo prints the error message: 

JOHN HAS NO VALUE t 


There are two ways of putting things or placing values inside 
these containers. The first, which we have already discussed, is 


by using procedures with inputs. The second is by using the f 
make command. r 

MAKE "JOHN 25 <r 

PRINT : JOHN f 

25 

make is a procedure needing two inputs: a word, and a value r 

which can be a word, a list, or a number. Here, it creates a f 

container called JOHN and places 25 inside it. Note that make f 

does not display anything on the screen. It is print that t 

displays this value. 

t 

We have here a good illustration of the difference between a i 
quote and a colon. The first input to make is "John because t 


the word JOHN itself is the input, which gives make the name of t 


a variable. The input to print is :JOHN because we want to f 

display the value of JOHN. 

Here is another example: ? 

MAKE "X "JOHN f 

PRINT : X * 

JOHN 

PRINT : J OHN 1 

25 ► 

In this case, make has two quoted words as inputs. It puts the 
literal word JOHN inside the container x. The contents of the 
variable named JOHN from the make of the previous example 
are left undisturbed. E 
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The Difference Between Global and Local Variables 

When Logo is at top level, and you create a variable with make, 
that variable will remain in your workspace until you erase it. 

For this reason, it is called a global variable. There are also 
variables that remain in the workspace only as long as a 
procedure is being executed. These are called local variables. 
Variables that are defined as inputs to procedures are always 
local variables. 

To see the difference, let us modify bigwelcome so that it 
prints the date. 

TO BIGWELCOME : NAME 
PR : DATE 
PR "HI 
PR : NAME 

PR [HAVE A NICE DAY] 

END 

Here, date could be a global variable which we haven't 
defined yet. If we try to run bigwelcome, we will get the error 
message 

DATE HAS NO VALUE IN BIGWELCOME 

We can use make at top level to give date a value. 

MAKE "DATE [JUNE 23 1983] 

BIGWELCOME "BRIAN 
JUNE 23 1983 
HI 

BRIAN 

HAVE A NICE DAY 

On the other hand, name is a local variable because it is an 
input to a procedure. It only contains the word Brian while the 
procedure bigwelcome is being executed. 
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It is easy to forget that you have created a global variable. You 
can always check which are in your workspace with the 
command pons. You can erase them with ern. Here is an 
example, that shows that name is truly local whereas date is 
truly global. 


ERN "DATE 

MAKE "DATE [JULY 1 1983] 
BIGWELCOME "SEYMOUR 
JULY 1 1983 
HI 

SEYMOUR 

HAVE A NICE DAY 


PONS 

MAKE 


"DATE [JULY 1 1983] 


There is no value displayed for name because name has 
disappeared after bigwelcome stops executing. 


When you use make inside a procedure definition, the variable 
can be either local or global. If it is an input to a running 
procedure then it is local. If it is not an input then it is global. 


Note that a procedure does not stop running when a 
subprocedure is called. Hence a variable that is local to a 
procedure can be used by its subprocedures. 


Understanding a Logo Line 


Procedure definitions consist of lines of instructions. We call 
these Logo lines because they can be much longer than the 
lines you see on your screen. For example: 

[BILL MARY JOHN JOE -» 


MAKE "MANYNAMES 
FRANK JUDY] 
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The arrow (->) indicates that the next screen line is a 
continuation of the first Logo line. You get long lines like this by 
continuing to type without pressing the return key. The 
right-arrow is automatically displayed and the instruction 
continues on the next line. The Logo line ends as soon as you 
press RETURN. 

Here are some guidelines or rules-of-thumb to help you 
interpret a complex Logo line. 

1 . Whenever you see a procedure name, be sure you know 

(a) how many inputs it has 

(b) whether it is a command or operation. 

2. The first word of a Logo line must always be a command. 

3. An operation is always the input to another procedure. 

4. Be sure to account for every input to a procedure. 

5. When the inputs to a command have been accounted for, 
the next procedure must be another command. 

Here is an example of a complex Logo line. It is part of a 
procedure comment that illustrates the use of the operation 
butlast in Chapter 2. 

PRINT SE [I AM] WORD BUTLAST :WD "IER 

Let us see how our guidelines help in understanding the line. 

print is a command with a single input. This must be the 
output of SE, which is an operation with two inputs. 

The first input to SE is the list [i AM], The second is the output of 
the operation word. The latter is, once again, an operation with 
two inputs. The first must be the operation butlast, which has 
a single input :WD. The second input to word must therefore 
be "ier. 
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Since there are no more procedure names and every input on 
the line has been accounted for, we have finished. The 
following diagram summarizes what we have done. 


[I AM] 


PRINT 
-SE - 


WORD 

BUTLAST "IER 

:WD 


So, for example, if the value of wd is happy then the line would 
print I AM HAPPIER. 
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How Primitives are Described 

The rest of this manual consists of a description of each 
primitive of ATARI Logo. 

In bold face at the beginning of each description, you will find 
the name of the primitive and its short form if one exists. We 
indicate on the same line whether the primitive is a command, 
an operation or an infix operation. The difference between a 
command and an operation is described in Logo Grammar. An 
infix operation is one that is placed between its inputs. All other 
primitives are written in front of their inputs. 

Below this, we indicate the name of the primitive, followed by 
the type of each input. All primitives must be entered in 
uppercase letters. You are to supply all inputs (shown in italics). 

This is followed by general information about the primitive and 
illustrations of how to use the primitive. 

How We Describe Formats 

If a primitive has more than one format, we write one below the 
other, with the simplest or most commonly used on the top line. 
You will see that, with some primitives (such as sum), an 
optional format is surrounded by parentheses. This indicates 
that the primitive will accept as many inputs as you wish. When 
using more than two inputs with such a primitive, you must 
always put a left parenthesis before its name and a right 
parenthesis after the last input. 

When we describe the kind of input that a primitive requires, 
we are not speaking about the way the input is written when 
you define the procedure, the rules for which were described 
in Logo Grammar. Logo tries to understand a written input by 
evaluating it and changing it to something else. Table 1 shows 
what these changes are. For example, if we write 

MAKE : X 22 + 23 

and x contains the word JOHN, then the real inputs to make are 
the word JOHN and the number 45. 


Table 1 


Written Input 

Word with quotes in front 
Word with colon in front 


Number 

List 

Procedure with inputs 


Real Input 

Word 

Contents of word. This can be 
a word, a list or a number. 

Number 

List 


Output of procedure. This can 
be a word, a list or a number. 


In this chapter and throughout the rest of the book, when we 
describe the kind of input that a primitive requires, we are 
speaking about the real input. With many primitives, an input 
can be anything you want. In other words, the real input can 
be a word, a list, or a number. We call this a Logo object. If you 
look up make, you will see that it must have the following form: 

make name object 

This uses two input words: name and object. Name means that 
the first input must be a word (we call a word a name if it is to 
be the name of something like a variable or a procedure) and 
object is an abbreviation for a Logo object. Going back to our 
example, we see that john is a word and 45 is a Logo object, 
so we do have the correct inputs. 

All of the words that we use in describing the inputs to the 
Logo primitives are explained on the next few pages. 


Input Words 

byte 

A unit of data used by the computer. An 
integer from 0 through 255. 

character 

Letters of the alphabet, numbers, and 
punctuation marks. 

colornumber 

An integer from 0 through 127. 

condnumber 

An integer from 0 through 21 . (See cond and 
when in Chapter 6 ) 

filename 

A file name. (See Chapter 10.) 

degrees 

Degrees of an angle. A real number between 
-9999.9999 and 9999.9999. The command 
repeat can be used to exceed this limit. 

device 

A device name. "C: is Cassette, "D: is Disk, and 
"P: is Printer. The " (quote mark) and : (colon) 
are required at all times. 

distance 

A number from -9999.9999 through 
9999.9999. The command repeat can be 
used to exceed this limit. 

duration 

An integer from 0 through 255. 

freq 

inputs 

An integer from 14 through 64,000 in Hz- 

Words with colons in front. Used in conjunction 
with TO. 


instructionlist A list of procedures that Logo can execute. 
joysticknumber An integer from 0 through 3. 
list Information enclosed in [ ] brackets. 

n, a, b, x, y A number. 

name A word naming a procedure or a variable. 

namelist A list of names. 


object 

paddlenumber 
pennumber 
position, pos 

pred 

shapenumber 

shapespec 

turtlenumber 

voice 

volume 

word 


A Logo object (a word, a list or a number). 

An integer from 0 through 7. 

An integer from 0 through 2. 

A list of two numbers giving the coordinates of 
the turtle or the cursor. 

A predicate, which is an operation that outputs 
either the word true or the word false. 

An integer from 0 through 15. 

A list of 16 numbers representing the shape 
grid. 

An integer from 0 through 3. 

An integer, either 0 or 1 . 

An integer from 0 through 15. 

A sequence of characters (not including a 
space). 
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When you use any primitive or procedure that refers to the 
turtle, Logo shows you the graphics screen. 

We give here a complete list of the commands that change 
what you see on the graphics screen. Also included are a 
number of operations that give you information about the 
turtle’s state. Most of them are discussed in the Introduction to 
Programming through Turtle Graphics Manual. 

ATARI Logo has four turtles that can perform dynamic actions. 
They are briefly mentioned in the Introduction Manual. 

□ Multiple Turtles 

With ATARI Logo, you can use up to four turtles at once. 
You can talk to the turtles together or separately. Four 
primitives allow you to address specific turtles. They are 
TELL, ASK, EACH and WHO. 

□ Dynamic Movement 

You can set the turtles in motion at the speed you choose 
by the command SETSP. speed tells you the speed of the 
current turtle(s). 

□ Changing the Turtle’s Appearance 

The turtles’ shapes and colors can be changed. You can 
create an unlimited amount of shapes in addition to the 
predefined turtle shape. The shape editor is used to design 
any shape you would like to use in place of the original 
turtle shape. The edsh command starts the shape editor. 
SETSH and SETC allow you set the shape and color of the 
current turtle, whereas shape and color output the 
appearance of the turtle you are currently talking to. 

□ Collision Detection 

Another feature that affects the extended turtle graphics 
capabilities is collision detection. The primitives relating to 
this feature are discussed in Chapter 6 (when, cond, 
over, touching) and Chapter 9 (pod, pods). 


24 


C 

c 

c 

c 

S. 

S 

S 

S 

6T 

S 

S 

s 

s 

s 

S 

s 

cr 

s 

s 

s 

C 7 

ST 

s 

s 

r 

c? 

S' 



s: 

S' 


S' 

ST 

ST 

$ 



Chapter 1 


Turtle Graphics 

ask command or operation 

ask turtlenumber instruction list 
ask turtlenumberlist instructionlist 

Asks the turtle(s) specified by turtlenumber(list) to run the 
instructions in the second input. This does not affect the turtle(s) 
you are currently giving commands to (that is the turtles 
addressed with tell). If instructionlist is an operation, ask 
outputs whatever the operation outputs. Turtlenumber is an 
integer from 0 to 3. 

EXAMPLE 

These instructions tell turtle 2 to point to the same heading as 
turtle 1. 

TELL 1 ST 
TELL 2 ST 
PR WHO 
2 

PU SETPOS C -30 0] 

SETH 180 

SETH ASK 1 [HEADING] 

PR WHO 
2 



back, bk command 

back distance 

Moves the turtle distance steps back. Its heading does not 
change. Note that back o (with pendown) displays a single dot 
at the turtle’s current position without moving the turtle. It is an 
error if distance is greater than 9999.9999 or less than 
-9999.9999. 


25 



BG 


operation 


BG 

Stands for BackGround. Outputs a number representing the 
color of the current background. When Logo starts, bg is light 
blue (74). See SETBG for setting the background colors. The 
ATARI computer has 16 colors, each having 8 possible 
shades, totaling 128 colors to choose from. 


0 

7 

gray 

8 

15 

light orange (gold) 

18 — 

23 

orange 

24 - 

31 

red-orange 

32 - 

39 

pink 

40 — 

47 

purple 

48 - 

55 

purple-blue 

56 - 

63 

blue 

64 

71 

blue 

72 — 

79 

light blue 

80 — 

87 

turquoise 

88 

95 

green-blue 

96 — 

103 

green 

104 — 

111 

yellow-green 

112 

119 

orange-green 

'20 — 

127 

light-orange 


For each color, the lowest number is the darkest shade of that 
color, and the highest number is the lightest shade of the color. 
For example, 0 is black and 7 is white. 

Note: Colors may vary depending upon the type of TV, monitor, 
condition, and color adjustments. Colors on pal systems may be 
different than the chart above. 
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clean command 


CLEAN 

Erases the graphics screen without changing the turtle’s state 
or the text displayed. 




CLEAN 


color operation 

COLOR 

Outputs a number representing the turtle’s current color. This 
can be any integer from 0 to 1 27. When Logo starts, turtle 0 is 
white (7), turtle 1 is orange (20), turtle 2 is purple (44), and turtle 
3 is blue (68). See bg for a chart of colors. See setc for 
changing the turtle’s color. 


cs command 

cs 

Stands for Clear Screen. Erases the graphics screen, puts the 
current turtle(s) at position [0 0] (the center of the screen), and 
sets the turtles’ heading to 0 (north), cs also clears any when 
demons that are in action (see when in Chapter 6). CS does not 
clear the text (see ct in Chapter 8). 
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each command 

each instructionlist 

Makes each turtle, currently in use, separately run the 
commands in instructionlist. If there is more than one active 
turtle, the first turtle executes all the commands in instructionlist 
before the second turtle does anything. This command is 
useful when you want each turtle to do slightly different things. 

EXAMPLES 

The following instructions make all the turtles line up 20 turtle 
steps apart and set their colors to the ones corresponding to 
their numbers. 



TELL 

[0 

1 2 3] 


HOME 





EACH 

[S 

ETX 

WHO 

* 20] 

EACH 

CS 

ETC 

WHO 

* 8] 


who outputs the identification number corresponding to each 
turtle. Thus, turtle 0 will do SETX 0 and SETC 0, turtle 1 SETX 20 
and setc 8, and so on. 

each, like ask, does not change which turtle(s) you are 
currently addressing. The difference is that ask runs each 
instruction for each turtle at the same time, each runs the 
instructions for one turtle after the other. The following example 
illustrates this: 
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TO SETUP 

CS TELL [0123] 
EACH [RT 90 * WHO] 
END 



SETUP 

ASK [0 12 3] [REPEAT 4 [ F D 50 RT 90-* 
]] 

SETUP 

EACH [REPEAT 4 [ F D 50 RT 90]] 


edsh command 

EDSH shapenumber 

Stands for EDit SHape. Starts up the Logo shape editor which 
allows you to make up your own shapes, edsh brings the 
shape corresponding to the shapenumber into the editor, 
shapenumber being an integer from 1 to 15. Note that shape 
number 0 is the normal turtle shape and can’t be edited. See 
the description at the end of this chapter for more information 
on the Turtle Shape Editor. 


forward, fd command 

forward distance 

Moves the turtle forward distance steps in the direction in 
which it is heading. Note that FORWARD 0 (with PENDOWN) 
displays a single dot at the turtle’s current position without 
moving the turtle. It is an error if distance is greater than 
9999.9999 or less than -9999.9999. 
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getsh operation 

GETSH shapenumber 

Outputs a list of 16 numbers representing the grid of the 
shapenumber (an integer from 1 through 15). Note that 
shapenumber can’t be 0. Each shape consists of an 8 column 
by 1 6 row grid. Each element in the list is the sum of the bit 
values for a row of the shape. 

128 64 32 16 8 4 2 1 column value 

7 6 5 4 3 2 1 0 column number 



Note that each column has a number and a value. The number 
is the power of 2 which corresponds to the value. For instance, 
2 to the power of 2 is 4. 

The first element in the list corresponds to the first row of the 
shape. If the whole row is filled in, this number is 255, the sum 
of all the column values. Each possible sum is unique. If only 
the right-most position of this row is filled in, this number is 1 . If 
only the fifth position from the right is filled in, this number is 1 6. 
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GETSH is useful for saving shapes on a disk or cassette. You 
must first store the shapes in variables and then save the 
workspace. (See Chapter 16 in the Introduction Manual for 
details.) 


EXAMPLES 

Let's suppose that shape number 1 is a filled-in box and shape 
number 2 is the outline of a box. 


PR GETSH 1 
255 255 255 
255 255 255 


255 255 255 255 255 255- 
255 255 255 255 



PR GETSH 2 
255 129 129 
129 129 129 


129 129 129 129 129 129- 
129 129 129 255 


□ 




HEADING 


operation 


HEADING 


Outputs the turtle’s heading, a number greater than or equal to 
0 and less than 360. Logo follows the compass system where 
north is a heading of 0 degrees, east 90 degrees, south 1 80 
degrees, and west 2 70 degrees. When you start Logo, the 
turtle has a heading of 0 (straight up). 


North 

0 ° 


West 270°- ! 90° East 

ik>° 

South 


home command 

HOME 

Moves the turtle to the center of the screen and sets its heading 
to 0. This command is equivalent to SETPOS [0 0] Seth 0. If the 
turtle’s pen is down, the turtle draws a line from its current 
position to HOME. 
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Turtle Graphics 

ht command 

HT 

Stands for Hide Turtle. Makes the turtle invisible, although it 
can still draw. 


left, lt command 

left degrees 

Turns the turtle left (counterclockwise) the specified number of 
degrees. It is an error if degrees is greater than 9999.9999 or 
less than -9999.9999. 

EXAMPLES 

left 45 (turns the turtle 45 degrees left) 



LEFT 45 


left - 45 (turns the turtle 45 degrees right) 



LEFT - 45 
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PC operation 

pc pennumber 

Stands for Pen Color. Outputs a number representing the color 
of the current pennumber 0, 1 , or 2. 

When Logo first starts, PC 0 is 15 (gold), PC i is 47 (purple), and 
PC 2 is 121 (orange). 


pe command 

PE 

Stands for Pen Erase. Puts the turtle’s eraser down. When the 
turtle moves, it will erase any previously drawn lines it passes 
over. To lift the eraser, use either pd, pu, or px. 


pen operation 

PEN 

Outputs a word describing the current state of the turtle’s pen: 
pd, pu, pe, or px. (See individual entries for further information.) 
When Logo first starts up, pen outputs pd. 


pendown, pd command 

PENDOWN 

Puts the turtle’s pen down: when the turtle moves, it draws a 
line in the current pen color. The turtle begins with its pen 
down. 


penup, pu command 

PENUP 

Lifts the pen up: when the turtle moves, it does not draw lines. 
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pn operation 

PN 

Stands for Pen Number. Outputs an integer (0, 1 or 2) 
representing the current pen number in use. ATARI turtles can 
use one of the three pens to draw. When Logo starts, pn is 0. 
SETPN is the command to tell the turtle which pen it should use. 
The color of each pen can be changed by the setpc 
command. 


pos operation 

POS 

Stands for POSition. Outputs the coordinates of the current 
position of the turtle in the form of a list [x y]. When you start 
Logo, the turtle is at [0 0], the center of the turtle field. See 
SETPOS for setting the turtle’s position. 


i ; 
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Due to aspect ratio this graph may not 
be the same. The correct aspect ratio 
for this graph is .SETSCR.8 


putsh command 

putsh shapenumber shapespec 

Gives shapenumber the specified shapespec as its shape. The 
output of getsh can be the input shapespec, in putsh. 
putsh allows you to define shapes under program control, as 
an alternative to using the shape editor. 
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EXAMPLES 

Using the replace procedure, you can change a row in an 
already-defined shape. 

TO REPLACE :P0S :NEWR0W : SH 

IF : POS = 1 COP SE : NEUROU BF : SH ] 

OP SE FIRST : SH REPLACE :P0S - 1 :NEW^ 

ROW BF : SH 
END 

PR GETSH 1 

255 255 255 255 255 255 255 255 255-* 

255 255 255 255 255 255 255 

Shapenumber 1 is a filled-in box. 

PUTSH 1 REPLACE 8 0 GETSH 1 

will put an empty line in the middle. 



Filled-in box New Shape 


TO CHANGESH :SH :POS :N 
IF : POS > 16 COP : SH] 

OP SE (FIRST : SH) - :N CHANGESH BF :S~* 

H : POS + 1 : N 

END 

If shapenumber 1 is still a filled-in box, 

PUTSH 1 CHANGESH GETSH 1 1 15 

will halve the size of each row. 
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px command 

PX 

Puts the “reversing pen” down: when the turtle moves, it 
draws where there aren’t lines and erases where there are. 

The exact effect of this reversal can be complex; what it looks 
like on the screen depends on the pen color, background 
color, and whether lines are horizontal or vertical. The best 
results are on a black background. To pick up the reversing 
pen, use pd, pu, or pe. 

px will work with setsp but the results are very inconsistent. 
Using these two primitives together is not recommended. 


right, rt command 

right degrees 

Turns the turtle right (clockwise) the specified number of 
degrees. It is an error if degrees is greater than 9999.9999 or 
less than -9999.9999. 

EXAMPLES 

right 45 (turns the turtle 45 degrees right) 



RT 45 


rs 


right -45 (turns the turtle 45 degrees left) 



RT -45 
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SETBG 

command 

SETBG colomumber 


Stands for SET BackGround. Sets the background color to the 
color represented by colomumber. There are 128 background 
colors to choose from (0 through 1 27). 

EXAMPLE 


The following procedure cycles through all the possible 
background colors. 

TO CHANGEBG 

IF BG = 127 [SETBG 0 WAIT 30] 

SETBG 1 + BG 

PR BG WAIT 30 

CHANGEBG 

END 


CHANGEBG 


To stop this procedure, press the break key. 


SETC 

command 

SETC colomumber 


Stands for SET turtle’s Color. Sets the color of the current turtle 
to colomumber (an integer from 0 through 1 27). 

SETH 

command 


seth degrees 

Stands for SETHeading. Turns the turtle at its position so that it 
is heading in the direction degrees. Positive numbers are 
clockwise from north. Note that right and left produce turns 
relative to the turtle’s heading, but SETH sets an absolute 
heading without reference to its prior heading. It is an error if 
degrees is greater than 9999.9999 or less than - 9999.9999. 

See HEADING. 
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EXAMPLES 

SETH 45 Heads the turtle northeast. 

SETH - 4 5 Heads the turtle northwest. 

PRINT HEADING 
315 



setpc command 

SETPC pennumber colornumber 

Stands for SET Pen Color. Sets the color of the pennumber (0, 

1 , 2) to colornumber (0 through 127). You can change the 
color of an already-drawn shape by changing its pen number 
or by assigning a new colornumber to that particular 
pennumber. 

You must assign a pennumber with SETPN prior to using setpc 
unless you are changing the current pen number. 

EXAMPLE 

REPEAT 4 [ FD 20 RT 90] 

SETPC 0 120 

If the above is done on starting Logo, the square will change 
color from gold to orange. 



command 


SETPN 

setpn pennumber 

Stands for SET Pen Number. Sets the pen, that the current 
turtle(s) are using, to pennumber. There are Three pens so 
choose from (0, 1 , 2). This determines which pen the Turtle 
uses to draw. Use SETPC to set the pen s color. When Log 
starts, the turtle(s) use(s) pen number 0. 


SETPOS 


command 


SETPOS position 

Stands for SET POSition. Moves the turtle to the position 
indicatedby a .is, o, ,wo numbers, [x and y coordinates,. (See 
POS) Both X and y take a maximum input of 99""" 
whether in window or wrap. If the turtle’s pen is down the 
turtle leaves a trace between its original and new positions. 


EXAMPLE 
SETPOS C80 0] 

moves the turtle to a point half way down the right edge of the 
screen. 



SETPOS [80 0] 
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setsh command 

SETSH shapenumber 

Stands for SET SHape. Sets the shape of the current turtle to 
the shape specified by shapenumber, which must be an 
integer in the range of 0 through 1 5. You create your own 
shapes using edsh or putsh. Shape 0, the turtle shape, cannot 
be changed. Shape numbers 1 through 15 start out blank 
every time Logo is booted. For more information, see the Turtle 
Shape Editor at the end of this chapter. 

EXAMPLE 

If you’ve changed the turtles to another shape this command 
changes every turtle to its normal shape: 

TELL [0123] SETSH 0 


setsp command 

setsp speed 

Stands for SET SPeed. Sets the current turtle’s speed (without 
altering its heading). If speed is greater than 0, the turtle will 
move forward. If speed is less than 0, the turtle will move 
backwards. If speed is equal to 0, the turtle stops moving. It is 
an error if speed is greater than 200, or less than - 200. Note 
that SETSP’s input does not need to be an integer. 

EXAMPLE 

This procedure makes each turtle move eastward at a random 
speed from 1 to 30: 

TO EASTWARD 


TELL 

[0 1 2 

3] 

ST 

SETH 

90 



EACH 

[SETSP 

1 

+ RANDOM 30] 

END 
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setx command 

SETXX 

Puts the turtle at a point with x-coordinate x (y-coordinate is 
unchanged). If the turtle’s pen is down, it will leave a horizontal 
trace. 

SETX -158 

moves the turtle horizontally to the left edge of the screen. 



SETX - 158 SETX 2 * XCOR 


sety command 

SETY y 

Puts the turtle at a point with y-coordinate y (x-coordinate is 
unchanged). 

SETY -119 

moves the turtle vertically down to the lower edge of the 
screen. 



SETY — 119 SETY 2 * YCOR 
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SHAPE 


operation 


SHAPE 


Outputs the number representing the shape of the current 
turtle. The normal turtle shape is 0. Note that the shape 
numbers are not the same as the turtle numbers (see example). 

EXAMPLE 


PUTSH 12 [255 255 255 255 255 255 25-> 
5 255 255 255 255 255 255 255 255 25-> 
53 

TELL 3 SETSH 12 
PRINT SHAPE 
12 


PRINT WHO 
3 


shownp operation 

SHOWNP 

Outputs true if the turtle is visible, false otherwise. Logo 
thinks the turtle is visible (even if you can’t see it) as long as it is 
within its boundaries. If the boundaries are set by window and 
you can’t see the turtle, shownp will still output true. 


speed operation 

SPEED 

Outputs the current turtle’s speed. Note that speed is defined 
as turtle steps per 1 6/60th’s of a second. 

speed may not output the exact speed that you originally gave 
as input to setsp. This has to do with the way Logo handles its 
arithmetic. 
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EXAMPLE 

This procedure halts any turtle that is exceeding the “speed 
limit”: 

TO HALT. AT :SPEED. LIMIT 

EACH [IF SPEED > :SPEED. LIMIT [SETSP -» 

0 ]] 

END 

TELL [0123] 

EACH [PU SETSP 10 + 20 * WHO] 

HALT. AT 40 

each is used because we want Logo to check each turtle’s 
speed. 


st command 

ST 

Stands for Show Turtle. Makes the turtle visible. See also ht. 

Note that if you have set the turtle's shape to an undefined 
shape, (getsh outputs a list of zeros), ST will not make the turtle 
visible. 


tell command 

tell turtlenumber 
tell turtlenumberlist 

Announces to Logo which turtle(s) you want to use. Unless you 
use tell to specify otherwise, the turtle commands you give 
will be addressed to turtle 0. 

The first time you address the other turtles with tell after Logo 
starts, they appear on the screen without having used the 
command ST. This is the only time that tell has this effect. 
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EXAMPLES 

The following instructions make turtle 3 red (40) and turtles 1 , 
2, and 0 blue (70): 

TELL 3 
SETC 40 
TELL [120] 

SETC 70 

tell can take a list of the same turtle numbers as its input. 

tell [0000] 

FD 10 

In this case FD 10 is repeated four times. 


who operation 

WHO 

Outputs the turtle number(s) you are currently talking to. The 
output is an integer or a list of integers from 0 through 3 
representing the four turtles available in ATARI Logo. 

This operation is useful with the each command when you 
want each turtle to carry out different instructions at the same 
time. 

EXAMPLES 

TELL [1 2] 

PR WHO 
1 2 


45 


The following instructions make the four turtles go forward in 
four directions at once. 

TELL [0123] 

HOME 

EACH [SETH 90 * WHO] 

FD 30 



window command 

WINDOW 

Makes the turtle field unbounded; what you see is a portion of 
the turtle field as if you were looking through a small window 
around the center of the screen. When the turtle moves 
beyond the visible bounds of the screen, it continues to move 
but can’t be seen. 

The entire turtle field is 251 19 steps high and 19841 steps 
wide. To hit the boundaries of window, you must repeat fd (or 
BK) a number of times with its highest input (9999.9999). 

When you give the window command, the screen is cleared. 
See also wrap. 

To create a smaller turtle field, use collision detection. 

EXAMPLE 

WINDOW 
CS RT 5 
FD 500 
PRINT POS 

43.5778 7 498.09735 
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wrap command 

WRAP 

Makes the turtle field wrap around the edges of the screen: if 
the turtle moves beyond one edge of the screen it appears and 
continues from the opposite edge. The turtle never leaves the 
visible bounds of the screen; when it tries to, it “wraps 
around”. Thus, the turtle can move forward (or back) an 
infinite amount of times without hitting the limits of the turtle 
field. 

When you give the wrap command, the screen is cleared. See 
also window. 

EXAMPLE 

WRAP 
CS RT 5 
FD 500 
PRINT POS 
43.57787 18.09735 


xcor operation 

XCOR 

Outputs the x-coordinate of the current position of the turtle. 


ycor operation 

YCOR 

Outputs the y-coordinate of the current position of the turtle. 
EXAMPLES 

CS PRINT YCOR 

0 

FD 100 
PRINT YCOR 
100 


lb 


The following procedure outputs the sine of an angle. The 
result is equivalent to the primitive sin. 

TO SINE : ANG LE 

HOME 

SETH 90 

LEFT : ANGLE 

FORWARD 100 

OUTPUT Y COR / 100 

END 

PRINT SINE 30 
0.5000021362 

Turtle Shape Editor 

You can create as many shapes as you want using the shape 
editor. But there are sixteen possible turtle shapes available at 
one time. Shape 0, the turtle shape cannot be changed. 

edsh is the command to start the Logo shape editor. Its input is 
the shapenumber (1 through 1 5). These shapes start out blank 
every time Logo starts up. edsh brings that shapenumber into 
the editor. Note that if you are defining shapenumber for the 
first time, the shape will be a large rectangular grid made out of 
8 by 16 small empty boxes. For example: 
edsh 1 
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T urtle Graphics 

There is no prompt character, but the cursor shows you where 
you are working. When you enter the shape editor, the cursor 
is in the top left box. 

Once you start the shape editor, you can move the cursor 
anywhere in the shape. You are able to pass over the boxes, 
and can create a shape by filling in the boxes or erasing them 
again using the space bar. 

Moving the Cursor and Changing the Shape 

Use the CTRL arrow keys to move the cursor around without 
changing the shape. To change what is under the cursor , 
press the space bar: a blank spot will become filled and a 
filled spot will become blank. This is how you define your 
shape. Remember to position the cursor before pressing the 
SPACE BAR. 

CTRL -*■ Moves the cursor right one space. 

Ctrl <- Moves the cursor left one space. 

CTRL t Moves the cursor up one line. 

CTRL 4 Moves the cursor down one line. 

On those ATARI Home Computers that are equipped with 
them, the function keys Fi, F2, F3 and F4 can be used to control 
the cursor. 

Do not press the ATARI key(A)or reverse video key(B) while 
in the shape editor. It disables the space bar function. 

Leaving the Shape Editor 

To leave the shape editor, press either ESC or break. 

esc Exits the shape editor saving the changes you 

have made. 

break Aborts the shape editor without saving any 

changes. 

See Chapter 1 6 of the Introduction Manual for an example of 
using the Shape Editor. 
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There are two types of objects in Logo: words and lists. There 
are primitives to put them together, take them apart, and 
examine them. 

A word is made up of characters. 

EXAMPLES 

HELLO 

X 

314 

3.14 

R2D2 

PIGLATIN 

PIG. LATIN 

HEN3RY 

WHO? 

INOW! 

These are all words. Each character is an element of the word. 
The word HEN3RY contains six elements: 

H E N 3 R Y 

A word is usually delimited by spaces. That is, there is a space 
before the word and a space after the word; they set the word 
off from the rest of the line. There are a few other delimiting 
characters: 

[]()= <> + -*/' 

To treat any of these characters as a normal alphabetic 
character, put a backslash “ \ ” before it. 

EXAMPLE 

PR " PIG LATIN 
PIG- LATIN 

Note that quotation marks (") and colon (:) are not word 
delimiters. 


C 

c 

c 

c 

c 

C - 

c - 
c - 
c 



c 

c 

C - 

c 

a 

c 

c 

c 

c 

c 

c 

fc 

s 

c 

C ■ 

r-f 
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and Lists 

A list is made up of Logo objects , each of which is a word or 
another list. We indicate that something is a list by enclosing it 
in square brackets. The following are all lists: 

[HELLO THERE, OLD CHAP] 

[XYZ] 

[HELLO] 

[[HOUSE MAISON] [WINDOW FENETRE] [DOG CHIEN]] 

[ HAL [C3PO R2D2] [QRZ] [ROBBIE SHAKEY]] 

[1 [1 2] [17 [17 2]]] 

N 

The list [hello there, old chap] contains four elements: 

HELLO 

THERE, 

OLD 

CHAP 

Note that the list [i [i 2 ] [17 [17 2 ]]] contains only three elements, 
not six; the second and third elements are themselves lists: 
Element 1 : i 
Element 2: [i 2 ] 

Element 3: [17[17 2 ]] 

The list ( 1, a list with no elements, is the empty list. There also 
exists an empty word, which is a word with no elements. You 
type in the empty word by typing a quotation mark, ", followed 
by a space. See entry for emptyp for examples of both the 
empty list and the empty word. 


The operations first, butfirst (BF), last and butlast (bl), 
are used to break words and lists into pieces. The following 
chart shows how they work. If you want to try out the operations 
in the table below use the command show. 


Operation 

Input 

Output 

FIRST 

"JOHN 

J 

BF 

"JOHN 

OHN 

FIRST 

[MARY JOHN BILL] 

MARY 

BF 

[MARY JOHN BILL] 

[JOHN BILL] 

FIRST 

[[MARY JOHN] BILL] 

[MARY JOHN] 

BF 

[[MARY JOHN] BILL] 

[BILL] 

FIRST 

[ ] or " 

error 

BF 

I 1 or " 

error 

last and butlast (BL) work in the same way separating the 
last element. 

Logo uses five operations to put words and lists together. 

These are fput, lput, list, se, and word. The following chart 
compares these five primitives: 

Operation 

input 1 input 2 

output 

FPUT 

"LOGO "TIME 

error 

LIST 

"LOGO "TIME 

[LOGO TIME] 

LPUT 

"LOGO "TIME 

error 

SE 

"LOGO "TIME 

[LOGO TIME] 

WORD 

"LOGO "TIME 

LOGOTIME 

FPUT 

[AND MORE] [TO COME] 

[[AND MORE] TO COME] 

LIST 

[AND MORE] [TO COME] 

[[AND MORE] [TO COME]] 

LPUT 

[AND MORE] [TO COME] 

[TO COME [AND MORE]] 

SE 

[AND MORE] [TO COME] 

[AND MORE TO COME] 

WORD 

[AND MORE] [TO COME] 

error 
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ascii operation 

ascii character 

Outputs the ASCII code for character. Appendix F contains a 
chart of all ASCII codes. If the input word contains more than 
one character, ASCII uses only its first character. See also 
CHAR. 

EXAMPLE 

The procedure SECRETCODE makes a new word by using the 
Caesar cipher (adding 3 to each letter): 

TO SECRETCODE :WD 
IF EMPTYP : WD [OUTPUT "] 

OUTPUT WORD CODE FIRST :WD SECRETCODE—* 

BF : WD 
END 

TO CODE : LET 

MAKE "NUM (ASCII : LET ) + 3 

IF : NUM > ASCII "Z [MAKE "NUM :NUM - -*■ 

263 

OUTPUT CHAR :NUM 
END 

PRINT SECRETCODE "CAT 

FDW 

PRINT SECRETCODE "CRAYON 
FUDBRQ 


BUTFIRST, BF 


operation 


BUTFIRST object 

Outputs all but the first element of object, butfirst of the 
empty word or the empty list is an error. 


EXAMPLES 


SHOW BF [BRIAN J . SMITH] 
[J. SMITH] 


SHOW 

OGS 

BF 

"DOGS 


SHOW 
[ ] 

BF 

[DOGS] 

The empty list 

SHOW 

BF 

[[THE A AN] 

[DOG CAT MOUS 

[BAR 

KS 

MEOWS] ] 



[[DOG CAT MOUSE] [BARKS MEOWS]] 


E] - 


PRINT BF " 

BF DOESN'T LIKE 

PRINT BF [ ] 

BF DOESN'T LIKE 


AS INPUT 
] AS INPUT 


The following procedure removes one element at a time from a 
word or a list. 


TO TRIANGLE :MESSAGE 
IF EMPTYP : MESSAGE [STOP] 
PRINT :MESSAGE 
TRIANGLE BF : MESSAGE 
END 

TRIANGLE "STROLL 

STROLL 

TROLL 

ROLL 

OLL 

LL 

L 


t 

t 

C 

C 

c 

c 

c 

tr 

tr 

tr 

tr 

c 

e 

s 

tr 

S' 

r 

r 

e 

* 

tr 

r- 

€~ 

«■ 

r 

d 

cr 



c 
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TRIANGLE [KANGAROOS JUMP GRACEFULLY] 
KANGAROOS JUMP GRACEFULLY 
JUMP GRACEFULLY 
GRACEFULLY 


BUTLAST, BL 


operation 


BUTLAST Object 

Outputs all but the last element of object, butlast of an empty 
word or an empty list is an error. 

EXAMPLES 

SHOW BL [I YOU HE SHE IT] 

[I YOU HE SHE] 

SHOW BL "FLOWER 
FLOWE 

SHOW BL [FLOWER] 

[ ] 

The input to the following procedure should be an adjective 
ending in y: 


(w TO COMMENT :WD 

-- PR SE [YOU ARE] :WD 

PR SE [I AM] WORD BUTLAST :WD " I ER 
END 

)Z COMMENT "FUNNY 

vw YOU ARE FUNNY 

vS I AM FUNNIER 


[5 
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CHAR 


operation 


CHARO 


Outputs the character whose ASCII code is n, an integer from 0 
through 255. Appendix F contains a chart of all ASCII codes. 


The 

ASCII cc 

0 

— 31 

32 

— 47 

48 

— 57 

58 

- 64 

65 

— 90 

91 

— 96 

97 

— 122 

123 

— 127 

128 

— 255 


graphic characters 


punctuation 
upper-case alphabet 


EXAMPLE 

TO LOWERCASE : LETTER 

MAKE "LC 32 + ASCII : LETTER 

IF AND : LC > 96 : LC < 123 COP CHAR : L-» 

C] COP : LETTER] 

END 


This procedure outputs the lowercase of an alphabet 
character. If you give it a character other than a letter of the 
alphabet, it outputs the same character. 


PRINT 

LOWERCASE 

"A 

a 

PRINT 

LOWERCASE 

"R 
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count operation 


count object 

Outputs the number of elements in a word or a list. 
EXAMPLES 

PRINT COUNT [A QUICK BROWN FOX] 

4 

PRINT COUNT [A [QUICK BROWN] FOX] 

3 

PRINT COUNT "COMPUTER 

8 

MAKE "CLASS [PAT JENNY CHRIS SCOT TO~> 

M MARY JUDY] 

PRINT COUNT : C LASS 

7 

The following procedure prints a random element of its input: 

TO RANPICK : DAT A 

PR ITEM (1 + RANDOM COUNT : DATA) : DAT — ► 

A 

END 

TO ITEM : N :OBJECT 

IF :N = 1 [OUTPUT FIRST rOBJECT] 

OUTPUT ITEM :N - 1 BF :OBJECT 
END 

RANPICK :CLASS see list class above 

SCOT 

RANPICK "COMPUTER 

M 


EMPTYP 


operation 


EMPTYP object 

Outputs true if object is the empty word or the empty list; 
otherwise false. 


EXAMPLES 



PR EMPTYP 
TRUE 

1 1 


PR EMPTYP 
FALSE 

0 


PR EMPTYP 
FALSE 

BF 

"UNICORN 

PR EMPTYP 
TRUE 

BL 

"U 

PR EMPTYP 
TRUE 

BF 

[UNICORN] 


The procedure, talk, matches animal sounds to animals: 

TO TALK : ANIMALS :SOUNDS 

IF OR EMPTYP : SOUNDS EMPTYP : AN IMALS -» 

[PR [THAT'S ALL THERE IS!] STOP] 


PR SE 

FIRST 

rANIMALS 

FIRST 

: SOUNDS 

TALK 

BF : AN 

IMALS 

BF : 

SOUNDS 


END 






TALK 

[DOGS 

BIRDS 

PIGS 

] [BAR 

K CHIRP 

INK] 






DOGS 

BARK 





BIRDS 

CHIRP 





PIGS 

OINK 





THAT' 

S ALL 

THERE 

IS ! 
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equalp operation 

equalp object 1 object2 

Outputs true if objectl and object2 are equal numbers, 
identical words, or identical lists; otherwise outputs false. 
Equivalent to = , an infix operation. 

EXAMPLES 

PR EQUALP "RED FIRST [RED YELLOW] 

TRUE 

PR EQUALP 100 50 * 2 
TRUE 

PR EQUALP [THE A AN] [THE A] 

FALSE 

PR EQUALP " [ ] 

FALSE 

(The empty word and the empty list are not identical.) 

The following operation outputs the position that the first input 
has in the second input and outputs 0 if it is not an element of 
the second. 

TO RANK : ONE : ALL 
IF EMPTYP : ALL [OUTPUT 0] 

IF EQUALP : ONE LAST : A LL [OUTPUT C0UN-+ 

T : ALL] 

OUTPUT RANK :0NE BL : A LL 
END 

PRINT RANK "TWO [ONE TWO THREE] 

2 

PRINT RANK "S "PERSONAL 
4 
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FIRST 


operation 


first object 

Outputs the first element of object. Note that first of a word is 
a single character; first of a list can be a word or a list. It is an 
error if the input is the empty word or empty list. 

EXAMPLES 

SHOW FIRST "HOUSE 

H 

SHOW FIRST CHOUSE] 

HOUSE 

SHOW FIRST [[THE A AN] [UNICORN RHIN-” 

0] [SWIMS FLIES GROWLS RUNS]] 

[THE A AN] 

The procedure item outputs the :Nth element of its second 
input. 


TO ITEM 

: N 

rOBJECT 


IF : N = 

1 

[OUTPUT FIRST 

: OB J ECT] 

OUTPUT 

ITEM :N - 1 BF : 

OBJECT 

END 




PR ITEM 
TUB 

3 

[CUP PUT TUB 

BUD] 

PR ITEM 

A 

4 

"STRAWBERRY 
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fput operation 

fput object list 

Stands for First PUT. Outputs a new list formed by putting 
object at the beginning of list. See the chart at the beginning of 
this chapter comparing fput with other operations that 
combine words and lists. 

EXAMPLE 

The procedure rev puts the elements of the input list in reverse 
order. 

TO REV : LIST 

IF EMPTYP : L I ST [OUTPUT [ ]] 

OUTPUT FPUT LAST :LIST REV BL :LIST 
END 

SHOW REV [ C F D 20] PU CRT 90] [ F D 20]-> 

PD [BK 20]] 

[ [ BK 20] PD [ FD 20] [RT 90] PU [FD 2 -► 

0 ]] 


last operation 

last object 

Outputs the last element of object, last of the empty word or 
the empty list is an error. 

EXAMPLES 

SHOW LAST [JUDY SUSAN BRIAN] 

BRIAN 

SHOW LAST "VANILLA 
A 

SHOW LAST [[THE A] FLAVOR IS [VANI LL~ * 

A CHOCOLATE STRAWBERRY]] 

[VANILLA CHOCOLATE STRAWBERRY] 




The following procedure prints a word in reverse order. 

TO PRINTBACK :INPUT 
IF EMPTYP : INPUT [STOP] 

TYPE LAST : INPUT 
PRINTBACK BL :INPUT 
END 

PRINTBACK "REVERSE 
ESREVER 


list operation 

list objectl object2 

Outputs a list whose elements are objectl, object2. Each input 
of list can be a word or a list. 

EXAMPLES 

SHOW LIST "ROSE [TULIP IRIS] 

[ROSE [TULIP IRIS]] 

SHOW LIST [ROSE] [TULIP IRIS] 

[[ROSE] [TULIP IRIS]] 


C 

F 

% 

f 

F 

F 

F 

F 

* 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F' 

F 

F~ 
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listp operation 

listp object 

Outputs true if object is a list; otherwise false. 

EXAMPLES 


PRINT 

FALSE 

LISTP 

3 


PRINT 

TRUE 

LISTP 

[3] 


PRINT 

TRUE 

LISTP 

[ ] 


PRINT 

FALSE 

LISTP 

II 


PRINT 

TRUE 

LISTP 

[A 

B C [D El [ 

PRINT 

FALSE 

LISTP 

BF 

"CHOCOLATE 

PRINT 

TRUE 

LISTP 

BF 

[CHOCOLATE] 


LPUT 


operation 


lput object list 

Stands for Last PUT. Outputs a new list formed by putting 
object at the end of list. See chart at the beginning of the 
chapter comparing lput with other primitives that combine 
words and lists. 

EXAMPLE 

The following procedure adds a new entry to an 
English-Spanish dictionary: 

TO NEWENTRY : ENTRY 

MAKE "DICTIONARY LPUT : ENTRY :DICTI0N-* 

ARY 

END 

MAKE "DICTIONARY [[HOUSE CASA] [SPAN-* 

ISH ESPANOL] [HOW COMO]] 

SHOW :DICTIONARY 

[[HOUSE CASA] [SPANISH ESPANOL] [HOW-* 

COMO] ] 

NEWENTRY [TABLE MESA] 

SHOW .-DICTIONARY 

[[HOUSE CASA] [SPANISH ESPANOL] [HOW-* 

COMO] [TABLE MESA]] 
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and Lists 


operation 


MEMBERP object list 

Outputs true if object is an element of list, otherwise outputs 
FALSE. 

EXAMPLES 


PRINT 

TRUE 

MEMBERP 

3 

C2536] 

PRINT 

FALSE 

MEMBERP 

3 

[2 5 [3] 6] 

PRINT 

FALSE 

MEMBERP 

[2 

5] [253 6] 

PRINT 

MEMBERP 

BF 

"FOG [OE FO OG OH] 


TRUE 

The following procedure determines whether its input is a 
vowel: 

TO V0WELP : LETTER 

OUTPUT MEMBERP : LETTER CA E I 0 U] 

END 

PRINT VOWELP "F 
FALSE 

PRINT VOWELP "A 
TRUE 


;2 

tO 

cs 

tO 

tO 

to 

to 

to 

to 

to 

to 

to 
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NUMBERP 


operation 

numberp object 

Outputs true if object is a number; otherwise false. 

EXAMPLES 

PRINT NUMBERP 3 

TRUE 

PRINT NUMBERP [31 

FALSE 

PRINT NUMBERP "7PM 

FALSE 

PRINT NUMBERP " 

FALSE 


PRINT NUMBERP BF 3165.2 

TRUE 


se operation 

se objectl object2 

(SE objectl object2 object3 ...) 

Stands for SEntence. Outputs a list made up of the elements 
included in its inputs. See the chart at the beginning of this 
chapter comparing se with other operations that combine 
words and lists. 

EXAMPLES 

SHOW SE "PAPER "BOOKS 

[PAPER BOOKS] 

SHOW SE "APPLE [PEAR PLUM BANANA] 

[APPLE PEAR PLUM BANANA] 

SHOW SE [TIME AND TIDE] [WAIT FOR N0~» 

PERSON] 

[TIME AND TIDE WAIT FOR NO PERSON] 
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co 

cs 

CO 

CO 

CO 

CO 

CO 

V S 

CO 

CO 

CO 

vw 

' 

V «» 

V W 


• 0 
,0 
■3 
3 
:3 
:3 
CO 
CO 

o 

CO 

CO 

CO 

CO 

0 


If se has more than two inputs, you must enclose SE and its 
inputs in parentheses. 

SHOW (SE "HOP "STEP "JUMP) 

[HOP STEP JUMP] 

SHOW SE "BONNIE [ ] 

[BONNIE] 

The following procedure prints a birth anouncement: 

TO ANNOUNCE : F I RSTN AME : LASTNAME 
PRINT [WE'RE HAPPY TO ANNOUNCE THE BI- 
RTH OF] 

PRINT ( S E : F I RSTN AME "Q. : LASTNAME) 

PRINT [5 POUNDS 14 OZ] 

END 

ANNOUNCE "RALPH "DOE 

WE'RE HAPPY TO ANNOUNCE THE BIRTH OF 
RALPH Q. DOE 
5 POUNDS 14 OZ 


word operation 

WORD word! word2 
(word wordl word2 word3 . . .) 

Outputs a word made up of its inputs. If word has more than 
two inputs, you must enclose word and its inputs in 
parentheses, word does not work with a list as its input. 

EXAMPLES 

PRINT WORD "SUN "SHINE 

SUNSHINE 

PRINT (WORD "CHEESE "BURG "ER) 

CHEESEBURGER 

PRINT WORD "BURG [ER] 

WORD DOESN'T LIKE [ER] AS INPUT 
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The procedure suffix puts ay at the end of its input: 

TO SUFFIX : WD 
OUTPUT WORD :WD "AY 
END 

PRINT SUFFIX "ANTEATER 
ANTEATERAY 

The essence of the procedure suffix is incorporated into PIG 
and latin, which translate into a dialect of Pig Latin: 

TO LATIN : SENT 
IF EMPTYP : SENT [OP C ]] 

OP SE PIG FIRST : SENT LATIN BF : SENT 
END 

TO PIG : WORD 

IF MEMBERP FIRST :W0RD [A E I 0 U] CO-" 

P WORD .-WORD "AY] 

OP PIG WORD BF :W0RD FIRST :WORD 
END 

PRINT LATIN [NO PIGS HAVE EVER SPOKE- 
N PIG LATIN AMONG HUMANS] 

ONAY IGSPAY AVEHAY EVERAY OKENSPAY I — 

GPAY ATINLAY AMONGAY UMANSHAY 


wordp operation 

wordp object 

Outputs true if object is a word; otherwise false. 

EXAMPLES 

PRINT WORDP "ZAM 
TRUE 

PRINT WORDP 3 
TRUE 

PRINT WORDP [3] 

FALSE 

PRINT WORDP [E GRESS] 

FALSE 
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= (Equal Sign) 


infix operation 


objectl = object2 


Outputs true if objectl and object2 are equal numbers, 
identical words, or identical lists; otherwise outputs false. 
Equivalent to equalp, a prefix operation. 


PRINT 3 = FIRST "3.1416 
TRUE 

PRINT [THE A AN] = [THE 
FALSE 

PRINT 1.-7 
TRUE 

PRINT " = [ ] 

FALSE 


A] 


A decimal number is equivalent to the 
corresponding integer. 

The empty word and the empty list are 
not identical. 
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A Logo word can be used as a variable ; a variable is a 
“container” that holds a Logo object. This object is called the 
word’s value. A variable can be assigned a value either by 
using make or by using procedure inputs. 


make command 

make name object 

Creates the variable name and gives it the value object. Once 
the variable is created, you can have access to its value by 
thing name. The abbreviation -.name means thing "name. 
The : (colon) means “the thing that is called”. 

EXAMPLES 

MAKE "NATIONS [CANADA USA FRANCE GER-> 

MANY ITALY] 

PRINT : NAT IONS 

CANADA USA FRANCE GERMANY ITALY 

PRINT "NATIONS 
NATIONS 

PRINT THING "NATIONS 

CANADA USA FRANCE GERMANY ITALY 

MAKE "USA [WASHINGTON] 

PRINT : USA 
WASHINGTON 

PRINT THING FIRST BUTFIRST :NATI0NS 
WASHINGTON 

first butfirst :NATiONS is the second word in the nation list, 
which is usa, and the value of thing "usa is Washington. 

MAKE "CANADA [OTTAWA] 

PRINT FIRST :NATI0NS 
CANADA 

PRINT THING FIRST :NATI0NS 
OTTAWA 
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Variables 


The following procedure capital asks for the capital cities of 
given countries. 

TO CAPITAL : NATIONS 
IF EMPTYP : NATIONS [STOP] 

MAKE "COUNTRY FIRST :NATI0NS 
PR SE [THE CAPITAL OF] .-COUNTRY 
MAKE "ANSWER RL 

IF : ANSWER = THING : COUNTRY [PR [C0RR-> 

ECT ! ] ] [PR [OH! SINCE WHEN?]] 

CAPITAL BF : NATIONS 
END 

CAPITAL : NAT IONS 
THE CAPITAL OF CANADA 
OTTAWA 
CORRECT ! 

THE CAPITAL OF USA 

NEW YORK 

OH! SINCE WHEN? 


NAMEP 


operation 



2 


25 


f5 

3 

3 

3 

"3 

3 


namep name 

Outputs true if name has a value, that is, if : name exists, 
false otherwise. 

EXAMPLES 

PRINT : AN IMA L 
ANIMAL HAS NO VALUE 

PRINT NAMEP "ANIMAL 
FALSE 

MAKE "ANIMAL "AARDVARK 
PRINT NAMEP "ANIMAL 
TRUE 

PRINT rANIMAL 
AARDVARK 

The procedure inc listed under thing below shows a use of 
NAMEP. 
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thing operation 

thing name 

Outputs the thing (or value) associated with the variable name. 
thing "any is equivalent to :ANY. The variable can be created 
by the command make or by defining a procedure with inputs. 

EXAMPLES 

MAKE "WINNER "COMPUTER 
MAKE "COMPUTER [100 POINTS] 

PRINT THING "WINNER 
COMPUTER 

PRINT : W I NNER 
COMPUTER 

PRINT THING :WINNER 
100 POINTS 

This procedure increments (adds 1 to) the value of a variable: 

TO INC : X 

IF NOT NAMEP :X [STOP] 

IF NUMBERP THING :X [MAKE :X 1 + TH I N— ► 

G :X] 

END 

Note: the use of make :X rather than make "x. It is not x that’s 
being incremented. The value of X is not a number, but the 
name of another variable. It is that second variable that is 
incremented. 

MAKE "TOTAL 7 
PRINT : TOTAL 

7 

INC "TOTAL 
PRINT : TOT A L 

8 

INC "TOTAL 
PRINT : TOTA L 
9 

For other examples, see entry for make. 
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Arithmetic 

Operations 



Logo has integer and decimal numbers: 

3 is an integer. 

3.14 is a decimal number. 

Logo provides primitives that let you add, subtract, multiply, 
and divide numbers. You can find sines, cosines, and square 
roots; and you can test whether a number is equal to, less 
than, or greater than another number. 

Some arithmetic operations (int, random, remainder, round) 
always output integers while others vary by the result of the 
operation. 

Decimal numbers with more than six digits are converted into 
exponential form (scientific notation). For example: 

2E6 means 2 times 10 2 * * * 6 , or 2 ,000,000; 

2.59E - 2 means 2.59 times 1 0 _ 2 , or 0.0259 

Exponents range from -99 to 97. 

Logo truncates a decimal number if it contains more than nine 
digits. For example, the number 2718281828459.045 is converted 

to 2.71 8281 82E+ 12. 

Addition, subtraction, multiplication, and division are available 
in infix notation ; that is, the operation goes between its inputs, 
not before them. Addition and multiplication are also provided 
in prefix form as Logo operations taking two or more inputs. 

For example, the following expressions are equivalent: 

2 + 1 

SUM 2 1 

In addition to those listed here, the primitive equalp is often 
used in conjunction with arithmetic operations. It is described in 

Chapter 2 — Words and Lists. The infix operation = (Equal 

Sign) is equivalent to equalp. 
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Arithmetic 

Operations 


cos operation 

cos n 

Outputs the cosine of n degrees. It is an error if n is greater 
than 9999.9999 Or less than -9999.9999 

EXAMPLES 

PRINT COS 45 
0.70714 

PRINT COS 30 
0.86605 

Here is a definition of the tangent function: 

TO TAN :ANGLE 

OUTPUT (SIN : ANGLE) / COS : ANGLE 
END 

PRINT TAN 45 
1 


int operation 

INTrt 

Outputs the integer portion of n (by removing the decimal 
portion, if any). See also round. 

EXAMPLES 


PRINT 

5 

INT 

5.2129 

PRINT 

5 

INT 

5.5129 

PRINT 

5 

INT 

5 

PRINT 

-5 

INT 

-5.8 

PRINT 

-12 

INT 

-12.3 
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The procedure intp tells whether its input is an integer: 
TO INTP : N 

IF NOT NUMBERP :N [OUTPUT [NOT A NUMB-> 
ER] ] 

OUTPUT : N = INT :N 
END 

PRINT INTP 17 
TRUE 

PRINT INTP 100 / 8 
FALSE 

PRINT INTP "ONE 
NOT A NUMBER 

PRINT INTP SQRT 50 
FALSE 


PRODUCT 


operation 


product a b 
(product a b c . ..) 

Outputs the product of its inputs. Equivalent to *, an infix 
operation. If product has more than two inputs, you must put 
parentheses around product and its inputs. 

EXAMPLES 

PRINT PROOUCT 6 2 
12 

PRINT (PRODUCT 234) 

24 

PRINT PRODUCT 2.5 4 

10 

PRINT PRODUCT 2.5 2.5 
6.25 
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Operations 


operation 


random n 

Outputs a random non-negative integer less than n. 

EXAMPLE 

random 6 could output 0, i, 2 , 3, 4, or 5. The following program 
simulates a roll of a six-sided die: 

TO 06 

OUTPUT 1 + RANDOM 6 


END 


PRINT 

D6 

3 


PRINT 

06 

5 


PRINT 

D6 


6 

Note: The outputs of D6 printed here are just possible 
numbers and will change because of random. 


remainder operation 

REMAINDER a b 

Divides a by b and outputs the remainder obtained. It is an 
error if b is 0. 

EXAMPLES 

PRINT REMAINDER 13 5 
3 

13 divided by 5 is 2 and the remainder is 3. 


PRINT 

13 

REMAINDER 

13 

PRINT 

-3 

REMAINDER 

-13 
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The following procedure tells you whether its input is even: 

TO EVENP : NUMBER 

OUTPUT 0 = REMAINDER : NUMBER 2 

END 

PRINT EVENP 5 
FALSE 

PRINT EVENP 12462 
TRUE 


RERANDOM 


command 


RERANDOM 


Makes random behave reproducibly. Once you run 
rerandom, Logo will remember the sequence of numbers 
obtained by the next random calls. After that, each time you 
run rerandom, random restarts the same sequence of 
random numbers from the beginning. (The input to random 
must be the same as the first time rerandom was run.) 

EXAMPLES 

REPEAT 4 [PR RANDOM 10] 

5 

2 

8 

4 


RERANDOM REPEAT 4 [PR RANDOM 10] 
8 
2 
3 
2 

RERANDOM REPEAT 4 [PR RANDOM 10] 
8 
2 
3 
2 
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round operation 

ROUND n 

Outputs n rounded off to the nearest integer. Compare with 
examples under int. 

EXAMPLES 


PRINT 

5 

ROUND 

5.2129 

PRINT 

6 

ROUND 

5.5129 

int works differently. 

PRINT 

5 

INT 5. 

5129 

PRINT 

1 

ROUND 

.5 

PRINT 

-6 

ROUND 

-5.8 

PRINT 

-12 

ROUND 

-12.3 


sin operation 


sin n 

Outputs the sine value of n degrees. See also COS. 

EXAMPLE 

PRINT SIN 45 
0.70714 


sort operation 

SQRT n 

Outputs the square root of n. It is an error if n is negative. 
EXAMPLES 

PRINT SQRT 25 
5 

PRINT SQRT 259 

16.093477 

The following procedure outputs the distance from the turtle’s 
position to HOME. 

TO FROM. HOME 

OP ROUND SQRT SUM XCOR * XCOR YCOR * -» 

YCOR 

END 

FD 50 

PR FROM. HOME 
50 

The procedure distance takes any two positions as inputs, 
and outputs the distance between them: 

TO DISTANCE :P0S1 :POS2 

MAKE "X (FIRST :P0S1)-FIRST :P0S2 

MAKE "Y (LAST :P0S1)-LAST :P0S2 

OUTPUT SQRT :X * :X + :Y * :Y 

END 

PRINT DISTANCE [-70 10] [50 60] 

129.9999 
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Arithmetic 

Operations 

sum operation 


SUM a b 
(SUM a b c ...) 

Outputs the sum of its inputs. Equivalent to + , an infix 
operation. If sum has more than two inputs, sum and its inputs 
must be enclosed in parentheses. 

EXAMPLES 

PRINT SUM 5 2 
7 

PRINT (SUM 132-1) 

5 

PRINT SUM 2.3 2.561 

4.861 



+ (Plus Sign) infix operation 

a + b 

Outputs the sum of its inputs, a and b. This is equivalent to 
sum, a prefix operation. 

EXAMPLES 

PRINT 5+2 
7 

PRINT 1 + 3 + 2 + 1 
7 

PRINT 2.54 + 12.3 

14.84 
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(Minus Sign) 


infix operation 

a - b 

Outputs the result of subtracting b from a. It may be used as 
the sign for a negative number. 

EXAMPLES 

PRINT 7 - 1 
6 

PRINT 7-1 
6 

PRINT PRODUCT 7 -1 
-7 

PRINT 
-50 

PRINT 
-3 

PRINT -3 - -2 
-1 

Note that there could be a confusion between the negative sign 
with one input and the minus sign with two inputs. Logo 
resolves this as follows: 

PRINT 3 * -4 3 times negative 4 

-12 

PRINT 3 + 4 - 5 3 plus 4 minus 5 

2 

If there is a space before the “ - ” and a number immediately 
after it, Logo reads that as a negative number. So 7 - 1 is 6 
but 7 - 1 is the pair of numbers 7 and -1 . 


-X COR 


- 3 


This number varies according to the 
turtle's position. 
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Operations 


The procedure abs outputs the absolute value of its input: 
TO ABS : NUM 

OUTPUT IF : NUM < 0 [ - : NUM ] [:NUM] 

END 

PRINT ABS -35 
35 

PRINT ABS 35 
35 


* (Multiplication Sign) infix operation 

a * b 

Outputs the product of its inputs a and b. This is equivalent to 
product, a prefix operation. 

EXAMPLES 

PRINT 6*2 

12 

PRINT 2+3*4 
14 

PRINT 1.3 * -1 .3 
-1 .69 

PRINT 48 * (.3 + .2) 

24 

The procedure factorial outputs the factorial of its input. For 
example, factorial 5 outputs the result of 5 * 4 * 3 * 2 * i (120). 

TO FACTORIAL :N 
IF :N = 0 [OUTPUT 1] 

OUTPUT : N * FACTORIAL :N - 1 
END 

PRINT FACTORIAL 4 
24 

PRINT FACTORIAL 1 

1 
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/ (Division Sign) 

infix operation 

a / b 


Outputs the result of a divided by b. 


EXAMPLES 


PRINT 6 / 3 
2 


PRINT 8 / 3 

2.66666666 


PRINT 2.5 / -3.8 

-0.6578947368 


PRINT 0/7 

0 


It gives an error if b is 0. 


PRINT 7/0 

/ DOESN'T LIKE 0 AS INPUT 


< (Less Than Sign) 

infix operation 


a < b 

Outputs true if a is less than b\ otherwise outputs false. 

EXAMPLES 

PRINT 2 < 3 

TRUE 

PRINT -7 < -10 

FALSE 
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= (Equal Sign) 

infix operation 

a = b 


Outputs true if a and b are equal numbers, identical words, or 
identical lists; otherwise outputs false. Equivalent to equalp, a 
prefix operation. 

EXAMPLES 


PRINT 100 = 50 * 2 
TRUE 


PRINT 3 = FIRST "3.1416 
TRUE 


PRINT 7.-1 
TRUE 

A decimal number is equivalent to the 
corresponding integer. 

PRINT " = [] 

FALSE 

The empty word and the empty list are 
not identical. 

> (Greater Than Sign) 

infix operation 


a > b 

Outputs true if a is greater than b; otherwise outputs false. 

EXAMPLES 

PRINT 4 > 3 

TRUE 

The procedure between outputs true if the number given as 
the first input is greater than the second input and less than the 
third. 

TO BETWEEN :N : LOW : H I 
OP AND :N > : LOW : H I > :N 
END 

PRINT BETWEEN 15 0 16 
TRUE 

PRINT BETWEEN -5 -2 5 
FALSE 
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There are two ways to define procedures. One way is with to 
and the other is with edit, to allows you to define a new 
procedure at top level without disrupting the graphics screen. 
edit allows you to use an interactive screen-oriented text editor, 
but at the same time you lose your graphics. You may define 
more than one procedure at a time in the editor. This is more 
flexible and convenient when you need to make some 
modifications. Although the editor is more extensively used, 
each method has its advantages and it is up to you to decide 
which one to use. 

ATARI Logo Editor 
How the Editor Works 

When the editor is called, the screen changes. For example 
EDIT "POLY 


jjO POLY : S I DE : ANG LE 

FD : S I DE 

RT : ANGLE 

POLY : S I DE : ANG LE 

END 


There is no prompt character, but the cursor shows you where 
you are typing. 

You can move the cursor anywhere in the text using the cursor 
control keys. You can also delete and insert characters using 
the appropriate keys described in this section. 
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Defining 
and Editing 
Procedures 

You can have more characters on a line of text than fit across 
the screen. When you get to the end of the line on the screen, 
simply continue typing without pressing the return key. An 
arrow (->•) will appear at the end of the line (column 37) and the 
cursor will move to the next line. Logo does the same thing 
outside of the editor. While in the editor you can type lines of 
any length. Outside the editor, a Logo line has a maximum 
length of 1 1 0 characters. 

This is how a long line would appear on the screen: 

TO PRINTMESSA6E :PERS0N 

PRINT SE : PERSON t, I AM GOING TO TYP-» 

E A VERY LONG MESSAGE FOR YOU] 

END 

The editor has a line buffer called the delete buffer, shift 
delete back S deletes a line of text and puts it in this buffer. 
Ctrl y reinserts this line of text later at the place marked by the 
cursor. The delete buffer can hold a maximum of 1 10 
characters. 

The text that you edit is in an edit buffer. The buffer has a 
capacity of 3840 characters. 

The arrow keys, Ctrl or shift function keys and some CTRL 
character key combinations have special meanings to help you 
edit. 


9 

9 
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Editing Actions 

When you are in the editor, you can use the following editing 
keys: 

‘The star represents editing keys that work both inside and 
outside the ATARI Logo Editor. 

Cursor Motion 


‘CTRL -» 

Moves the cursor right one space. 

‘CTRL <- 

Moves the cursor left one space. 

CTRLl 

Moves the cursor down to the next line. 

CTRL t 

Moves the cursor up to the previous line. 

‘CTRL A 

Moves the cursor to the beginning of the 
current line. 

‘CTRLE 

Moves the cursor to the end of the current 
line. 

CTRL X 

Moves the cursor to the beginning of the 
editor. 

CTRL Z 

Moves the cursor to the end of the editor. 


Note: Any time you try to make the cursor go where there is no 
text, Logo will beep. 
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Inserting and Deleting 

•return return creates a new line at the current 


•CTRL INSERT 

cursor position and moves the cursor to the 
beginning of the new line. 

Opens a new line at the position of the 
cursor but does not move the cursor. 

•DELETE BACK S 

Erases the character to the left of the 
cursor. 

•CTRL DELETE 
BACKS 

Erases the character at the cursor 
position. Compare with delete back s. 

•CTRL CLEAR 

Deletes text from the cursor position to the 
end of the current line. This text is placed in 
the delete buffer, which can hold up to 1 1 0 
characters. 

•CTRLY 

Inserts the text that is currently in the delete 
buffer. 

•SHIFT DELETE 
BACKS 

Same as Ctrl clear. 

•SHIFT INSERT 

Same as Ctrl insert. 


Scrolling the Screen 

•Ctrl i Makes Logo stop scrolling until Ctrl i is 


CTRL V 

pressed again. 

Scrolls the screen to the next page in the 
editor. 

CTRL W 

Scrolls the screen back to the previous 
page in the editor. 


Exiting From the Editor 

esc ESC is the standard way to exit from the 

editor. 

When you exit from the editor by pressing 
esc, Logo reads each line in the edit buffer 
as though you had typed it outside the 
editor. 

If you forgot to type the end at the end of 
the definition, Logo inserts END for you. 

You can define more than one procedure 
while in the editor, as long as each 
procedure is terminated by end. 

If there are Logo instructions in the edit 
buffer that are not contained in the 
procedure definition (within to . . . end), 
Logo carries them out as you exit from the 
editor just as if you had typed them in at 
top level (outside the editor). Logo will not 
carry out any graphics commands or 
editing commands. 

break Aborts editing. Use it if you don’t like the 

changes you are making, or if you decide 
not to make changes. If you were defining 
a procedure, the definition will be the same 
as before you started editing. 
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edit, ed command 


edit name 
edit namelist 

Starts up the ATARI Logo Editor. If an input is given, the editor 
starts up with the definition(s) of the given procedure(s) in the 
edit buffer. The input to edit can be a list of procedure names 
instead of a single name. In this case, all the procedure 
definitions will be brought into the editor. 

If the procedure name has not been previously defined, the 
edit buffer contains only the title line: to name. If no input is 
given, the edit buffer has the same procedures as the last time 
you used the editor, or is empty if it is the first time you have 
used the editor. 

Press the esc key to complete the definition and exit the editor. 
Logo reads every line from the edit buffer as though you had 
typed it outside the editor. If the end of the buffer is reached 
while there is a procedure definition in the editor, Logo 
completes the procedure definition and inserts END. 


EDNS 


command 


EDNS 

Stands for EDit NameS. Starts up the Logo Editor with all 
names and their values in it. These variables’ names and 
values can then be edited. When you exit the editor the make 
commands are run, so whatever variables and values have 
been changed in the editor are changed in Logo. 

EXAMPLE 

Type 

EDNS 

The screen now looks like: 

MAKE "ANIMAL "GIBBON 
MAKE "SPEED 55 

MAKE "AIRCRAFT [JET HELICOPTER] 

Edit the names so they will look like the list below. Then press 
esc to exit the editor. 

MAKE "ANIMAL "GRYFFIN 
MAKE "SPEED 55 

MAKE "AIRCRAFT [JET HELICOPTER BLIMP] 

Then 

PONS 

MAKE "ANIMAL "GRYFFIN 
MAKE "SPEED 55 

MAKE "AIRCRAFT [JET HELICOPTER BLIMP] 


end special word 

END 

end is necessary, when you are using to, to tell Logo that you 
are done defining the procedure. It must be on a line by itself. 
end also must be used to separate procedures when defining 
multiple procedures in the Logo Editor. 
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Defining 
and Editing 
Procedures 

to command 


to name inputl input2... 

? TO GREET 

> PR I NT [HI THERE] 

> END 

GREET DEFINED 

?l 

?T0 SQUARE : SIDE 

> F D : SIDE 

>RT 90 

> F D : S I DE 

>RT 90 

>FD : S I DE 

>RT 90 

>FD : S I DE 

>RT 90 

>EN D 

SQUARE DEFINED 

?l 

to tells Logo that you are defining a procedure called name, 
with inputs (if any) as indicated. (It is not necessary to quote 
name, since to quotes it automatically.) The prompt changes 
from “?” to “ > ” to remind you that you are defining a 
procedure. While defining a procedure Logo does not carry 
out the instructions that you type; it makes them part of the 
procedure definition. 

To complete the procedure and return Logo to top level, type 
the word end as the last line of the procedure. The special 
word end must be used alone on the last line of the procedure 
to stop defining a procedure and return Logo to top level. 

If you change your mind while defining a procedure with TO, 
press the break key to abort the definition. If a procedure is 
already defined, you can't change the definition with to. You 
must use edit or erase the old definition first with er. 
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Chapter 6 


Flow of Control 
and Conditionals 



Logo reads procedure definitions line by line, following the 
instructions. If a procedure contains a subprocedure, Logo 
reads the lines of the subprocedure before continuing in the 
superprocedure. Flow of control refers to the order in which 
Logo follows instructions. There are times you want to alter 
Logo’s normal flow of control. There are several ways to do it. 

conditionals “if such-and-such is true, do one thing; 

otherwise, do something else.” 
repetition “run a list of instructions one or more times.” 

halting “stop this procedure before it reaches the 

END.” 

Conditionals enable Logo to carry out different instructions, 
depending on whether a condition is met. Logo predicates, 
operations that output true or false, create this condition, 
which is the first input to IF. 

Repetition can be done by using repeat or a recursive 
procedure. There are many examples of such procedures 
throughout this manual. (See run for examples of some 
complex repetitive procedures.) 

You can halt a procedure before it reaches an end statement. 
The commands stop and output are used for this. Control is 
then transferred back to its calling procedure (the procedure 
using it) or to top level. As described in Logo Grammar, 
output can communicate information to the calling procedure. 
Note that these commands (stop and output) only halt the 
procedure they appear in. 

The when demon is a completely different way to alter the flow 
of control. It is a global condition that needs to be set up only 
once. Whenever that condition is met within any procedure, or 
at top level, a set of instructions is run. 

You can think of the when demon as sitting inside the Logo 
world, spending all its time watching for a certain event. 
Whenever this event occurs, it jumps up and tells Logo to run a 
list of instructions. Then the when demon resumes its watch. 
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Chapter 6 


Flow of Control 

and Conditionals 

The primitive that sets up the demon is called when. The 
events that when can check are listed in the following table. 

If you forget the number corresponding to an event, there are 
two primitives, over and touching, that can help you (see 
Appendix B in the Introduction Manual for examples). 

COND is another primitive which can check these events. Unlike 
when, cond can only check an event at the moment Logo 
reads the line containing it. 
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Table of Collisions and Events 

Code Number 

Inputs 


Collision 

Special 

event 

Turtle 

number 

Pen 

number 

Description 
of event 

0 


0 

0 


1 


0 

1 


2 


0 

2 



3 



Button on Joystick is pressed 

4 


1 

0 


5 


1 

1 


6 


1 

2 



7 



Once per second 

8 


2 

0 


9 


2 

1 


10 


2 

2 


11 




Not used 

12 


3 

0 


13 


3 

1 


14 


3 

2 



15 



Joystick position is changed 

Collision 

number 


Turtle 

number 

Turtle 

number 


16 


3 

0 


17 


3 

1 


18 


3 

2 


19 


0 

1 


20 


0 

2 


21 


1 

2 
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Flow of Control 
and Conditionals 

Each number in the table is a symbol for a collision or event. 
For example, collision number 0 stands for a collision between 
turtle 0 and a line drawn by pen number 0. Event number 3 
stands for whether a button on a joystick is pressed. 

Note: It is best to work with a full screen of graphics (FS) when 
using when demons 2 , 6 , 10 and 14 . In ss (splitscreen), the 
turtle(s) may collide with text. 


cond operation 

COND condnumber 

Outputs true if the collision or event specified by condnumber 
is happening at the exact time cond is run, otherwise false. 
The input is an integer between 0 and 21 indicating which 
collision or event you want to check (see the table page 104). 
cond is most useful when you want to check for an event only 
once. Compare with when. 

EXAMPLE 

In the following example, shape number 1 is a filled-in box that 
acts as a target, cond checks whether you have hit the target 
by looking for a collision between turtle 0 and turtle 1 . 

TO SHOOT 
SETUP 


PR 

[HOW 

MUCH 

DO 

YOU 

WANT 

TO 

TURN RIGH-* 

T? ] 








RT 

FIRST 

RL 






PR 

[HOW 

MUCH 

DO 

YOU 

WANT 

TO 

MOVE?] 

FD 

FIRST 

RL 






IF 

COND 

19 [ 

PR 

[YOU 

GOT 

IT! ] 

] [ PR [BAD-*’ 

LU 

CK] ] 









TO SETUP 

TELL [0 1] CS ST 
TELL 0 PU 
RT RANDOM 360 
FD RANDOM 80 
SETH 0 PD 
SETSH 1 
TELL 1 
END 

SHOOT 


HOW 

MUCH 

DO 

YOU 

WANT 

TO 

TURN RIGHT? 

45 

HOW 

MUCH 

DO 

YOU 

WANT 

TO 

MOVE? 


50 

BAD LUCK 



if command or operation 

if pred instruct ion list 

if pred instructionlistl instructionlist2 

The first input, pred, is a predicate or condition that if tests to 
be true or false. If pred is true, instructionlistl is run. If pred 
is false, instructionlist2 is run. (Nothing is done if there is no 
instructionlist2.) 

in either case, if the selected instructionlist outputs, then if 
outputs the same thing. If the list does not output, neither does 
if. Note that if you use if with just one instructionlist, and follow 
it on the same line with another command, Logo will print an 
error message. 
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EXAMPLES 

The procedure decide is written in three equivalent ways. The 
first two use if as a command, one version with two inputs to 
if, one with three inputs. The third version of decide uses if 
(with three inputs) as an operation. 

if as a command: 
to decide 

IF 0 = RANDOM 2 COP "YES] 

OP "NO 
END 

TO DECIDE 

IF 0 = RANDOM 2 [OP "YES] [OP "NO] 

END 

if as an operation: 

TO DECIDE 

OUTPUT IF 0 = RANDOM 2 ["YES] ["NO] 

END 

You will get the answer YES or NO with any definition. 

PRINT DECIDE 
YES 

if can be used inside of another if clause. For example, 

TO POSITIVE : NUM 

IF NUMBERP : NUM [IF :NUM > 0 [PR [P0S-* 

ITIVE NUMBER]] [PR [NEGATIVE NUMBER]]-* 

] [PR [NOT A NUMBER] ] 

END 


o utput, op command 

output object 

This command can be used only within a procedure, not at top 
level. It makes object the output of this procedure and returns 
control to the caller. Note that output is itself a command, but 
the procedure containing it is an operation because the 
procedure is made to output (compare with stop). 


EXAMPLES 


TO MARK. TWAIN 

OUTPUT [SAMUEL CLEMENS] 

END 

PR SE MARK. TWAIN [IS A GREAT AUTHOR] 
SAMUEL CLEMENS IS A GREAT AUTHOR 

item outputs the nth element in the list: 

TO ITEM : N :OBJ 
IF EMPTYP : OB J [OUTPUT "] 

IF : N = 1 [OP FIRST :OBJ] 

OP ITEM : N— 1 BF :OBJ 
END 

MAKE "VOWELS [A E I 0 U] 

PR ITEM 2 : VOWELS 
E 

PR ITEM 5 : VOWE LS 
U 

PR ITEM 6 : VOWELS 


The following procedure tells whether its first input is a subset 
of its second input. It outputs true or false. This is how you 
make your own predicate. 

TO SUBSET : SUB : ALL 
IF EMPTYP : SUB [OUTPUT "TRUE] 

IF MEMBERP FIRST :SUB : ALL [OP SUBSET-* 


BF : SUB : ALL] 
END 

[OP 

"FALSE] 


PRINT SUBSET 
FALSE 

[W 

E] 

[A E I 0 

U] 

IF SUBSET [I 

E] 

[A 

E I 0 U] 

[PR "VOWEL 


S] 

VOWELS 
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Flow ot Control 
and Conditionals 

over operation 

over turtlenumber pennumber 

Outputs number symbolizing a collision between turtlenumber 
and pennumber. (See table of collisions and events at the 
beginning of this chapter.) over can be used as an input to 
WHEN or COND. 

EXAMPLE 

PR OVER 1 0 
4 


repeat command 

repeat n instructionlist 

Runs a list of instructions the specified number of times. It is an 
error if n is negative. If n is not an integer it is truncated to an 
integer. 

EXAMPLES 

REPEAT 4 [ F D 80 RT 90] 

draws a square 80 turtle steps on a side. 



REPEAT 4[FD 80 RT 90] 

REPEAT 5 [PRINT RANDOM 20] 
Prints 5 random numbers from 0 to 19. 
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The following procedure draws polygons: 

TO POLY : S IDE : ANG LE 

REPEAT 360 / : ANG LE [ FD :SIDE RT :ANG— ► 
LE] 

END 

POLY 50 120 


o 


POLY 50 120 


RUN 


command or operation 


run instructionlist 

Runs the specified list of instructions as if it were typed in 
directly. If instructionlist is an operation, then run outputs 
whatever instructionlist outputs. 

EXAMPLES 

The following procedure simulates a calculator: 

TO CALCULATOR 
PRINT RUN RL 
PRINT [] 

CALCULATOR 

END 

CALCULATOR 
2 + 3 
5 

17.5 * 3 

52.5 

42 = 8 * 7 

FALSE 

REMAINDER 12 5 

2 
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Press the break key to stop. 

The procedure while runs a list of instructions while a specified 
condition is true: 

TO WHILE : CON D I T I ON : INSTRUCTIONLIST 
IF NOT RUN : CONDITION [STOP] 

RUN : INSTRUCTIONLIST 

WHILE : CONDITION : INSTRUCTIONLIST 

END 

RT 90 

WHILE [ XCOR < 100] C F D 25 PR POS] 

25 0 
50 0 
75 0 
100 0 


The following procedure applies a command to each element 
of a list in turn: 


TO MAP : CMD :LIST 
IF EMPTYP : LI ST [STOP] 

RUN LIST : CMD WORD "" FIRST :LIST 

MAP : CMD BF :LIST 

END 


TO SQUARE : S I DE 

REPEAT 4 [ F D :SIDE RT 90] 

END 

MAP "SQUARE [10 20 40 80] 



MAKE "NEW. ENGLAND [ME NH VT MA RI] 
MAP "PRINT :NEW. ENGLAND 
ME 



The following procedure, forever, repeats its input forever 
(unless it encounters an error or is stopped with the break 
key): 

TO FOREVER : INSTRUCT ION LI ST 
RUN : INSTRUCTIONLIST 
FOREVER : INSTRUCTIONLIST 
END 

The command forever [FD i rt i] tells the turtle to draw a 
circle. 



FOREVER (FD1 RT1] 


The command, forever [PR run rl pr []] is equivalent to the 
calculator procedure defined above. 

run rl runs any commands or operations typed in by the user. 

pr run rl prints the output from any expression typed in by 
the user. 


stop command 

STOP 

Stops the procedure that is running and returns control to the 
caller. This command is meaningful only when it is within a 
procedure — not at top level. Note that a procedure containing 
stop is a command (compare output). 

EXAMPLE 

TO COUNTDOWN :NUM 
PR : NUM 

IF : NUM = 0 [PR [BLAST OFF!] STOP] 

COUNTDOWN : NUM - 1 
END 
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Flow of Control 
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COUNTDOWN 4 
4 
3 
2 
1 
0 

BLAST OFF! 


touching operation 

touching turtlenumberl turtlenumber2 

Outputs the number symbolizing a collision between 
turtlenumberl and turtlenumber2. (See table at the beginning 
of the chapter.) touching can be used as an input to when or 

COND. 

EXAMPLE 

PR TOUCHING 2 3 
18 


wait command 

wait n 

Tells Logo to wait for n 60ths of a second. 

EXAMPLE 

The procedure slowed makes the turtle go forward very 
slowly. 

TO S LOW F D : DIST 

REPEAT : D I ST [ FO 1 WAIT 1] 

END 

S LOW F D 80 
CS 

REPEAT 4 [ S LOW F D 80 RT 90] 
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command 


WHEN 


when condnumber instruction list 
when condnumber [ ] 

Sets up a when demon for detecting a collision or event 
condnumber. (See table at the beginning of the chapter.) 
Condnumber is an integer from 0 to 21 symbolizing an event. 
When this event occurs, instructionlist is run. If the instructionlist 
includes turtle commands, the current turtle(s) carries them out. 

The when command must be given while in splitscreen or 
fullscreen. 

Note that when’s effect is global: this command needs to be 
given only once. See POD and pods in Chapter 9 for checking 
which demons are in action. 

when condnumber [ ] 

Since most condnumbers refer to a graphics command, it may 
be impossible to work in the textscreen mode while a when 
demon is still alive. There are two ways you can clear a when 
demon so that it no longer watches for an event or collision. 

The simplest way is to give the CS command. A side-effect is 
your design on the graphics screen is also cleared. The best 
method is to give the command when condnumber [ ], since a 
demon is inactive if it has no task to perform. For example, if 
you want to clear when demons 0 and 4, type 

WHEN 0 [ ] 

WHEN 4 [ ] 

pods allows you to check if these demons are still active, 
poos 

There are no active demons. 

Note: an error message or the edit command will automatically 
clear the active demons. 
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It is possible to give more than one when command at one 
time, but the demons will not be active simultaneously. Their 
speed in detecting a collision or event depends on their 
strength, when demon 0 is the strongest and therefore the 
fastest demon; when demon 21 is the weakest and slowest. 
When one demon is busy (its event is occurring), the other 
demons go to sleep and don’t wake up until the first demon 
has completed its task. 

When setting up a game or project using demons, it is helpful 
to follow these guidelines: 

1 . Try to give a when demon a task (instruction list) that can 
be executed as fast as possible. 

2. The best way to use when demons is to give the instruction 
SETSP o and then use a helping procedure to examine 
each turtle’s state. 

3. The helping procedure shouldn’t do anything except watch 
for a condition, and call a collision processing procedure if 
the collision occurred. 

4. The collision processing procedure must always leave the 
turtle affected by a when demon out of a collision situation. 
If not, the turtle could be caught on a line and eventually 
escape its bounds. 

EXAMPLES 

Whenever the joystick changes position (event number 1 5), 
joyh is executed, allowing you to draw with the joystick. 

TO JOYH 

IF (JOY 0) < 0 [STOP] 

SETH 45 * JOY 0 

FD 5 

JOYH 

END 

WHEN 15 [JOYH] 


3 
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The following program sets the turtle in motion. When you 
press the button on your joystick (event number 3), the turtle 
acts like a spring. 

TO PLAY 
CS ST PD 

REPEAT 4 C F D 100 RT 90] 

PU SETPOS C50 50] 

WHEN 3 [SPRING 100] 

SETSP 10 
END 

TO SPRING : SPEED 
IF : SPEED < 1 [STOP] 

FD : SPEED WAIT 50 BACK :SPEED 

SPRING : SPEED/2 

END 

PLAY 

Here is a set of procedures that makes a square and keeps 
four turtles inside it. 

TO SETUP 

TELL [0123] CS ST PU 
SETPN 0 SETPC 0 120 

ASK 0 [SETPOS [-50 -50] PD REPEAT 4 [-» 

FD 100 RT 90] PU] 

ASK 0 [SETPOS [-20 -20]] 

ASK 1 [SETPOS [-20 20]] 

ASK 2 [SETPOS [20 -20]] 

ASK 3 [SETPOS [20 20]] 

EACH [RT 90 * WHO] 

END 

TO DEMONS. TASK 
WHEN 0 [SETSP 0] 

WHEN 4 [SETSP 0] 

WHEN 8 [SETSP 0] 

WHEN 12 [SETSP 0] 

END 


C 

C- 

C 

C 

C- 

t- 

C- 


CT 

CT 

UT- 

C 

C* 

tr 


I 

I 

I 

I 

I 

I 

I 

I 

I 


6T 


W 

fcT 


tr 

*=• 


: i 
: i 

P 

- 

: ! 




1 


j 


116 


Chapter 6 



Flow of Control 
and Conditionals 


TO WATCH 

IF SPEED = 0 [FIND. THEM] 

WATCH 

END 

TO FIND. THEM 

IF COND 0 [ASK 0 [BK 10 RT 180]] 

IF COND 4 [ASK 1 [BK 10 RT 180]] 

IF COND 8 [ASK 2 [BK 10 RT 180]] 

IF COND 12 [ASK 3 [BK 10 RT 180]] 

SETSP 30 
END 

SETUP 

DEMONS. TASK 
WATCH 

setup sets up the square and the four turtles in it. 
demons. task sets up the when demons, watch is a helping 
procedure that calls the collision processing procedure, 

FIND. THEM. 
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Recall that predicates are operations that output only true or 
false. Most of their names end in p. 


There are some Logo predicates whose inputs must be true 
or false. These are called logical operations. Their names do 
not end in p. The designers of ATARI Logo have chosen to 
retain the traditional names and, or, and not for these logical 
operations. They are used to combine predicates into logical 
expressions. This is similar to the way in which arithmetic 
operations form arithmetic expressions. Just as arithmetic 
operations receive and output only numbers, so logical 
operations receive and output only true or false. 

The inputs to logical operations are usually predicates. 
Predicates are found throughout the other chapters of this 
manual. 


Predicate 

COND 

EMPTYP 

EQUALP 

JOYB 

KEYP 

LISTP 

MEMBERP 

NAMEP 

NUMBERP 

PADDLEB 

SHOWNP 

WORDP 

< 

> 
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and operation 

and predl pred2 

(and predl pred2 pred3 . . .) 

Receives two or more inputs, and outputs true if all its inputs 
are true, false otherwise. 

EXAMPLES 

PRINT AND "TRUE "TRUE 
TRUE 

PRINT AND "TRUE "FALSE 
FALSE 

PRINT AND "FALSE "FALSE 
FALSE 

PRINT (AND "TRUE "TRUE "FALSE "TRUE) 

FALSE 

PRINT AND 5 7 
7 IS NOT TRUE OR FALSE 

PRINT AND (PC 1) = 0 BG = 0 
FALSE 

(The infix operation = returns true or false to and.) 

The following procedure, decimalp, tells whether its input is a 
decimal number: 

TO DECIMALP :OBJ 

OP AND NUMBERP :0BJ CHECK :0BJ 

END 

TO CHECK : OB J 

IF EMPTYP : OBJ [OP "FALSE] 

IF EQUALP FIRST :0BJ ". [OP "TRUE] 

OP CHECK BF : OB J 
END 

PRINT DECIMALP 17 
FALSE 

PRINT DECIMALP 17.0 
FALSE 
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Note that Logo interprets a number as an integer if it ends with 
a decimal point and a zero or just a decimal point. 

PRINT DECIMALP 48.098 
TRUE 

PRINT DECIMALP "STOP. 

FALSE 


FALSE 

special word 

FALSE 


false is a special input for and, if, not and or. 


NOT 

operation 

not pred 


I 


a 

a 

a 

S 

I 




Ca 
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1 
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I 


I 


I 
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Outputs true if pred is false; outputs false if pred is true. 
EXAMPLES 

PRINT NOT EQUALP "A "B 
TRUE 

PRINT NOT EQUALP "A "A 
FALSE 

PRINT NOT "A = FIRST "DOG 
TRUE 

PRINT NOT "A 
A IS NOT TRUE OR FALSE 

If wordp were not a primitive, it could be defined as follows: 

TO WORD? : OB J 

OUTPUT NOT LISTP :0BJ 

END 
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The following procedure tells whether its input is a “word that 
isn’t a number”: 

TO REALWORDP :0BJ 

OUTPUT AND WORDP :0BJ NOT NUMBERP :OB-> 

J 


END 



PRINT 

FALSE 

REALWORDP 

HEADING 

PRINT 

TRUE 

REALWORDP 

"KANGAROO 

PRINT 

TRUE 

REALWORDP 

PEN 


or operation 

OR predl pred2 

(OR predl pred2 pred3 ...) 

Outputs true if any of its inputs are true, false otherwise. 
EXAMPLES 

PRINT OR "TRUE "TRUE 
TRUE 

PRINT OR "TRUE "FALSE 
TRUE 

PRINT OR "FALSE "FALSE 
FALSE 

PRINT OR 5 7 
7 IS NOT TRUE OR FALSE 


The procedure mountains draws “mountains”: 

TO MOUNTAINS 
CS 

RT 45 

SUBMOUNTAIN 

END 

TO SUBMOUNTAIN 
FD 5 + RANDOM 10 

IF OR Y COR > 50 YCOR < 0 CSETH 180 - -*• 
HEADING] 

SUBMOUNTAIN 

END 



MOUNTAINS 


true special word 

TRUE 

true is a special input for and, if, not, and OR. 
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The Outside 
World 



This chapter describes primitives for communicating with 
various devices through the computer. The devices include the 
keyboard, the TV screen and special purpose devices such as 
joysticks. If you are using a television or a monitor with volume 
control, you can also take advantage of the ATARI Logo music 
primitives, toot and setenv. 

The ATARI Computer has 24 lines of text on the screen, with 
38 characters on each line. The screen can be used entirely for 
text or entirely for graphics. You can also split the screen using 
the top nineteen lines for graphics and the bottom five lines for 
text. When you start up Logo, the entire screen is available for 
text. The cursor on the text screen is similar to the turtle on the 
graphics screen. You can put characters anywhere on the text 
screen by setting the cursor at the desired place. 

In addition to those primitives described in this section, the 
commands save, load, setread, and setwrite are related to 
communication with the outside world. They are described in 
Chapter 10. 


ct command 

CT 

Stands for Clear Text. Clears the text from the screen and puts 
the cursor at the upper left corner of the text part of the screen. 

fs command 

FS 

Stands for Full Screen. Devotes the entire screen to graphics. 
Only the turtle graphics show; any text you type will be invisible 
to you, although Logo will still carry out your instructions. The 
text will reappear when you switch back to SS or ts mode. 

If Logo needs to type an error message while you are in FS, it 
automatically goes back to ss. 
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The CTRL f key combination has the same effect as fs. In 
addition, CTRL F can be pressed while a procedure is running, 
whereas you must wait to get the ? (prompt) in order to type fs. 

Note that if you give the CT command when the screen has 
been switched to fs, the cursor goes to the top of the 
textscreen. When you switch the screen back to ss 
(splitscreen), the cursor will be hidden by the graphics portion 
of the screen. 


joy operation 

JOY joysticknumber 

Outputs a number between - 1 and 7 representing the 
position of the joystick. 



The input must be 0, 1 , 2, or 3, that is, the number of the 
joystick being used. It is an error if you give any other input. If 
the joystick is in its initial position, (you have not moved it), JOY 
outputs - 1 . See Appendix C in the Introduction Manual for 
examples. 

joyb operation 

joyb joysticknumber 

Outputs true if the button on the specified joystick is down, 
false otherwise. The input must be 0, 1 , 2, or 3, since there 
are 4 joysticks. It is an error if you give any other input. If there 
are no joysticks connected, joyb outputs false. See Appendix 
C in the Introduction Manual for examples. 
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KEYP 


operation 


KEYP 

Outputs true if there is at least one character waiting to be 
read on the keyboard or any other device set by setread, 
false if there isn’t any. 

EXAMPLE 

The following procedures keep the turtle going forward by 
small steps. Whenever you press R the turtle turns rt 10 ; when 
you press l the turtle turns lt 10 . 

TO STEER 
FD 2 

IF KEYP [TURN RC] 

STEER 

END 

TO TURN : D I R 

IF : D I R = "R [RT 10] 

IF : D I R = "L CLT 10] 

END 


paddle operation 

paddle paddlenumber 

Outputs a number between 0 and 247, representing the 
rotation of the dial on the specified paddle. Paddlenumber is an 
integer from 0 through 7. It is an error if you give any other 
input. If there is no paddle connected, paddle outputs - 1 . 

EXAMPLE 

The following procedure allows you to draw on the screen by 
rotating paddle 0 to change the turtle's heading, and paddle 1 
to move the turtle forward. 

TO PDRAW 

RIGHT (PADDLE 0) / 25.6 
FORWARD (PADDLE 1) / 25.6 
PDRAW 
END 
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PADDLEB 


operation 


paddleb paddlenumber 

Outputs TRUE if the button on the specified paddle is down, 
false otherwise. Paddlenumber must be an integer from 0 
through 7 since there are a maximum of eight paddles. It is an 
error if any other input is given. If there are no paddles 
connected, paddleb outputs false. 

EXAMPLE 

The procedure drive allows you to control the turtle’s 
movement by the button. It will turn around in a circle while you 
hold down the button of paddle number 0, and will go in a 
straight line when you release it. 

TO DRIVE 

IF PADDLEB 0 [RIGHT 5] 

FORWARD 2 

DRIVE 

END 


print, pr command 

print object 

(print objectl object2 . . .) 

Prints its input(s) on the screen, followed by return. The 
outermost brackets of lists are not printed. Compare with type 
and show. 

EXAMPLES 

PRINT "A 
A 

PRINT "A PRINT [A B C] 

A 

ABC 

(PRINT "A [A B C]> 

A A B C 

PRINT [ ] 
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TO REPRINT : MESS AGE : HOWMANY 
IF : HOWMANY < 1 [STOP] 

PR : MESSAGE 

REPRINT :MESSAGE tHOWMANY - 1 
END 

REPRINT [TODAY IS FRIDAY!] 4 

TODAY IS FRIDAY! 

TODAY IS FRIDAY! 

TODAY IS FRIDAY! 

TODAY IS FRIDAY! 


RC 


operation 


RC 

Stands for Read Character. Outputs the first character read 
from a device or the keyboard. This character can even be a 
CTRL character. If no character is waiting to be read, RC waits 
until the user types something. This character is not echoed on 
the screen. If the end of file position has been reached in a file 
being read, RC outputs an empty word. See also keyp. 


EXAMPLE 

The following procedure lets the user run certain commands 
with a single keystroke (F does forward 5, and R does right 
10). No return is needed. 


TO DRIVE 

MAKE "CHAR RC 

IF : CHAR = "F [FD 5] 

IF : CHAR = "R [RT 10] 

IF : CH AR = "L [LT 10] 

DRIVE 

END 
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The Outside 
World 


operation 


RL 

Stands for Read List. Outputs as a list the first line of words 
read from the keyboard or a device. If no list is waiting to be 
read, RL waits for the user to type something. If lists have 
already been typed, it outputs the first line that has been typed 
but not read. Whatever you type will be echoed on the screen. 
If the end-of-file position has been reached in a file being read, 
rl outputs an empty list. 

EXAMPLES 

TO GET. USER 

PRINT [WHAT IS YOUR NAME?] 

MAKE "USER RL 

PRINT SE [WELCOME TO LOGO,] :USER 
END 

GET. USER 

WHAT IS YOUR NAME? 

HARRY 

WELCOME TO LOGO, HARRY 


setcursor command 


SETCURSOR position 

Sets the cursor to position. The first element of position is the 
column number; the second, the line number. Lines on the 
screen are numbered from 0 to 23 character positions, 
columns from 0 to 37. 

It is an error if the line number is not between 0 and 23, or if the 
column number is not between 0 and 37, or if an element of 
position is not an integer. Note that column 37 is reserved for 
the -* (line continuation arrow). 

EXAMPLE 
SETCURSOR [35 12] 

The cursor moves half-way down the right edge of the screen. 
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SETENV 


command 


setenv voice duration 

SETENV is an envelope shaper which reduces the volume of 
the given voice (0 or 1) by 1 unit every duration (units of 1/60 
second). The default duration is zero, which bypasses this 
modification, and consequently “sounds just like a computer”. 

EXAMPLE 

TO TONE0 : DUR 
TOOT 0 440 15 : DUR 
END 

TO T0NE1 : F R :DUR 
TOOT 1 : F R 15 :DUR 
END 

TO TIMEOUT 

TONE0 120 T0NE1 110 30 T0NE1 220 30 
TONE0 60 T0NE1 330 30 T0NE1 448 30 
END 

SETENV 0 6 
SETENV 1 2 
REPEAT 6 [TIMEOUT] 
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show command 

show object 

Prints object on the screen, followed by a carriage return. If 
object is a list, it is printed with brackets around it. Compare 
with type and print. 

EXAMPLES 


SHOW 

A 

"A 





SHOW 

A 

"A 

SHOW 

[A 

B 

C] 

[A B 

C] 





TYPE 

"A 

TYPE 

[A 

B 

c] 

AA B 

C 






PRINT "A PRINT [A B Cl 

A 

ABC 


ss command 

ss 

Stands for Split Screen. Splits the screen into the turtle field and 
the text field. The first graphics command given after you start 
up Logo will automatically switch to ss: the top nineteen lines 
of the screen are available for graphics, and the bottom five 
lines are reserved for text. 

The Ctrl s key combination gives the same affect as the ss 
command. See also FS and ts. 

Note: that if you give the CT command while the screen is in ss, 
the bottom five lines are cleared of text, but the top nineteen 
lines on the text screen remain unchanged. 


TOOT 


command 


toot voice frequency volume duration 

Generates a tone via audio output specified by voice (0 or 1). 
Frequency is specified in Hertz (cycles per second) and can go 
from 14 to above audibility. (440 is the tuning note A.) Volume 
may range from 0 to 1 5. Duration may range from 0 to 255; it is 
measured in units of 1/60 second. 

If a second toot to the same voice is attempted, Logo will wait 
until the first toot is finished. 

EXAMPLE 

TO SOUND. RANGE : FREQ 
TOOT 0 : FREQ 15 15 
PR : F REQ 

SOUND. RANGE : FREQ + 50 
END 

SOUND. RANGE 14 


ts command 

TS 
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Stands for Text Screen. Devotes the entire screen to text; the 
turtle field will be temporarily invisible to you until a graphics 
procedure is run. The Ctrl t key combination is equivalent to 
ts. In addition, Ctrl t can be used while a procedure is still 
running, whereas to type TS, you have to wait until you get the 
prompt. See also ss and fs. 
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World 


type command 

type object 

(type objectl object 2 . . .) 

Prints its input(s) on the screen, not followed by a carriage 
return. The outermost brackets of list are not printed. Compare 
with print and show. 

EXAMPLES 

TYPE "A 

A7TYPE "A TYPE [A B C] 

AA B C? (TYPE "A [A B C]) 

AA B C? 

The procedure prompt types a message followed by a space: 

TO PROMPT :MESSAGE 
TYPE :MESSAGE 

TYPE " \ Backslash followed by a space. 

END 

TO MOVE 

PROMPT CHOW MANY STEPS SHOULD I TAKE?— ► 

] 

FD FIRST RL 

MOVE 

END 

MOVE 


HOW 

MANY 

STEPS 

SHOULD 

I 

TAKE? 

50 

HOW 

MANY 

STEPS 

SHOULD 

I 

TAKE? 

37 

HOW 

MANY 

STEPS 

SHOULD 

I 

TAKE? 

2 

HOW 

MANY 

STEPS 

SHOULD 

I 

TAKE? 

108 
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Your workspace comprises the variables and procedures that 
Logo knows about right now. It does not include primitives. 

There are several primitives that let you see what you have in 
your workspace. You can also selectively erase procedures 
from your workspace. 

The workspace is a temporary space. Your procedures and 
variables will be erased when you turn off the power of the 
computer. If you want to keep them for future use, you must 
store them on a diskette or cassette in the form of files. See 
Chapter 10 for information on files. 

Note that any command starting with er clears the edit buffer. 

If after giving such a command you give the edit command 
with no input, the editor will not contain any procedures. 

erall command 

ERALL 

Stands for ERase ALL. Erases all procedures and variables 
from the workspace. This command also frees up all nodes of 
the system. Make sure that all the procedures you want to keep 
are saved in a file before you use this command. 

erase command 

erase name 
erase namelist 

Erases the named procedure(s) from the workspace. This 
command does not affect the procedure(s) saved in a file. 

EXAMPLES 

ERASE "TRIANGLE 

erases the triangle procedure. 

ERASE [TRIANGLE SQUARE] 

erases the triangle and square procedures. 


138 


TaLSLMlii MiMLSLA Si Si Mi Si *J SI Si Si 8) 3131 Ml SHI Ml ?) 31AS JLT -71 TJ! T 


Chapter 9 


I VeJ 
( & 
( t» 
(& 
(to 
(to 
(to 
(to 
(to 
(to 
(to 
(to 
(to 
(to 
(to 
(to 
(to 
( to 
(to 
(to 

(o 

(to 

(to 

(to 

(to 

(to 

(to 

(to 

(G 

(Ci 

(to 

(to 

(to 

(to 

(3 

(to 



Workspace 

Management 

ern command 

ern name 
ern namelist 

Stands for ERase Name. Erases the named variable(s) from the 
workspace. 

EXAMPLES 
ERN "LENGTH 

erases the length variable. 

ERN [LENGTH PI] 

erases the length and pi variables. 


erns command 

erns 

Stands for ERase NameS. Erases all variables from the 
workspace. 


erps command 

ERPS 

Stands for ERase Procedures. Erases all procedures from the 
workspace. 


nodes operation 


NODES 

Outputs the number of free nodes. This gives you an idea of 
how much space you have in your workspace for procedures, 
variables, and running procedures, if you want to find out 
exactly how many nodes you have left, run nodes immediately 
after recycle. 
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po command 


PO name 
po namelist 

Stands for Print Out. Prints the definitions of the named 
procedure(s). You cannot print out any Logo primitives. 

EXAMPLES 

PO "POLY 

TO POLY : S I OE : ANG LE 

FD : S I D E 

RT : ANG LE 

POLY : S I OE : ANG LE 

END 
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PO [POLY GREET] 

TO POLY : S I DE : ANG LE 

FD : S I DE 

RT : ANG LE 

POLY : S I DE : ANGLE 

END 

TO GREET 
PRINT [HI THERE] 

END 


poall command 

POALL 

Stands for Print Out ALL. Prints the definition of every 
procedure and the value of every variable in the workspace. 

EXAMPLES 

POALL 

TO POLY : S I DE : ANGLE 

FD : S I DE 

RT : ANG LE 

POLY : S I DE : ANG LE 

END 
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TO SPI : S I DE : ANG LE :INC 
FD : S I DE 
RT : ANG LE 

SPI : S I DE + : INC : ANG LE : I NC 
END 

MAKE "ANIMAL "AARDVARK 
MAKE "LENGTH 3.98 
MAKE "MYNAME "PAT 


pod command 

pod condnumber 

Stands for Print Out Demon. Prints out the condition and action 
set up for when demon condnumber. Condnumber stands for 
collision number or event number (see table at the beginning of 
Chapter 6). See when for setting up a when demon. 

EXAMPLES 

POD 0 

There is no when demon 0 set up. 

WHEN 0 [BK 10] 

POD 0 

WHEN 0 [BK 10] 


PODS 

command 

PODS 


Stands for Print Out Demons. Prints out the conditions and 
actions set up for all the when demons. 

EXAMPLES 


PODS 

WHEN 0 [BK 10] 
WHEN 3 [SETSP 0] 
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PONS 


command 


PONS 

Stands for Print Out NameS. Prints the name and value of 
every variable in the workspace. 

EXAMPLE 

PONS 

MAKE "ANIMAL "AARDVARK 
MAKE "LENGTH 3.98 
MAKE "NAMES [LINDA MIKE] 


pops command 


POPS 

Stands for Print Out Procedures. Prints the definition of every 
procedure in the workspace. 

EXAMPLE 

POPS 

TO POLY :SIDE : ANG LE 

FD : S I DE 

RT : ANG LE 

POLY : S I DE : ANG LE 

END 

TO GREET 
PRINT [HI THERE] 

END 

TO SPI : S I DE : ANG LE : I NC 
FD : S I DE 
RT : ANG LE 

SPI :SIDE + : I NC : ANG LE :INC 
END 
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pots command 


POTS 

Stands for Print Out Titles. Prints the title line of every 
procedure in the workspace. 

EXAMPLE 

POTS 

TO POLY : S I OE : AN6 LE 
TO GREET 

TO SPI : S I OE : ANGLE : INC 


recycle command 

RECYCLE 

Performs a garbage collection, freeing as many nodes as 
possible. When you don't use recycle, garbage collections 
happen automatically whenever necessary, but each one takes 
at least one second. Running recycle before a 
time-dependent activity prevents the automatic garbage 
collector from slowing things down at an awkward time. See 
NODES. 
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The procedures and variables you created in the workspace 
will be erased when you turn off the power of the computer. If 
you want to keep them for future use, you can store them on a 
diskette or cassette. The information is organized in files. You 
decide what should go into each file. 

You can create a file containing a copy of all characters 
displayed on the textscreen. This "dribble” file created by the 
command setwrite gives a record of the interactions between 
the person at the keyboard and the computer. You can read 
any file line by line with the command setread. 

A printer is considered as a special kind of a file. For example, 
you can list the contents of the procedures and names in your 
workspace by saving them on a printer. 

The input for a file command always specifies the device being 
used: 

C: stands for cassette 
D: stands for disk drive 1 

on: stands for disk drive n (n is a disk drive number from 1 
through 4) 

P: stands for printer 

When D:, di: or Dr?: (disk drive) is the input, a file name must 
also be specified. If you use a file name with any other device, 
this input will be ignored. The only exception is catalog where 
D:, Di:, or Dr?: is used alone. 

A filename can be 1 to 8 characters long with an optional 3 
character extension. The first character of the filename must be 
a letter. All letters in the filename and extension must be 
uppercase. If an extension is used, a period must be used to 
separate the filename from the extension. 
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Files 

catalog command 

catalog device: 

Prints on the screen the names of all the files on the disk, if 
device: is a disk drive. If device: is a cassette (”C:), all the 
procedure definitions and names will be displayed. 

EXAMPLES 
CATALOG "D: 

lists the files on disk in the current drive. 

CATALOG "D2: 

lists the files on disk in drive 2. 

CATALOG "C: 

lists all the procedure definitions and names in the cassette file. 


erf command 

erf device:filename 

Erases the file named filename from the diskette. It is an error if 
there is no file by the name you have specified. 

The only device that can be used with erf is a disk drive. If you 
have more than one drive, the drive number must be specified. 

EXAMPLE 

ERF "D:BEAR 

erases the file called bear from your disk. 


LOAD 


command 


load device-filename 

Loads the contents of filename into the workspace, as if typed 
in directly. It is an error if filename doesn’t exist or if you try to 
load from the printer. The break key interrupts load. 

After the file is loaded, you can verify the content using various 
print out commands. (See Chapter 9 — Workspace 
Management.) For specific information on using a cassette to 
load or save, see Chapter 5 in the Introduction Manual. 

EXAMPLES 

ERALL 

Your workspace is now empty. 

LOAD " D1 : BE AR 
EYES DEFINED 
PLAY DEFINED 
JOYH DEFINED 

LOAD "C: 

EYES DEFINED 
PLAY DEFINED 
JOYH DEFINED 

SAV e command 

save device-filename 

Creates a file named filename and saves in it all procedures 
and variables in the workspace. 

Never use the break key when a file is being saved: you will 
lose your workspace. 

It is good practice to check before save what you are saving 
and erase names of the procedures you don’t need. See pots, 
po, poall and erase in Chapter 9. 
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Files 

EXAMPLES 

SAVE "D:MARIO.001 

saves the contents of the workspace into the file called 
mario . 001 on a disk. 

SAVE "C: 

saves the contents of the workspace onto cassette. (See 
Chapter 5 in the Introduction Manual for details on saving files 
on a cassette.) 

SAVE *P: 

prints the contents of the workspace on a printer. 


SETREAD command 

SETREAD device.iilename 

SETREAD [ ] 

Sets the device: from which to receive input. Filename can be a 
program file or a file created by setwrite. After the command 
SETREAD is given, rc and rl read information from this 
devicefilename. 

SETREAD [ ] 

SETREAD [ ) closes the file being read. 

You can only SETREAD to one file at a time but you can open a 
file for reading (setread) and writing (setwrite) at the same 
time. 


EXAMPLES 


SETREAO "D : BEAR 
REPEAT 4 [PR RL] 

TO EYES 
REYE 
LEYE 
END 

The first lines of the bear file are printed. 

SETREAD C ] 

The file is closed. Now rl and RC will be read from the 
keyboard. 

See setwrite for more examples. 

setwrite command 

setwrite device:filename 

SETWRITE [] 

Opens file named device-filename and starts the process of 
sending a copy of all the characters displayed on the 
textscreen to device-filename . 

SETWRITE [ ] 

setwrite [ ] closes the file. 

You can only setwrite to one file at a time but you can 
SETREAD and setwrite at the same time. It is an error if you 
setwrite to a device that is not connected or turned on after 
booting Logo. To read a file created with setwrite, use the 
command setread. 
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EXAMPLES 

SETWRITE "D : SEPT1 

opens a file called septi on diskette. Now everything 
appearing on the textscreen will be sent to the septi file. 

fd 40 
RT 90 

SETWRITE "D : SEPT2 

The septi file is automatically closed and the SEPT2 file is 
opened. 

FD 30 
RT 45 

SETWRITE [ ] 

The SEPT 2 file is closed. 

SETREAD "D : SEPTI 
opens the septi file for reading. 

REPEAT 4 [PR RL] 

FD 40 
RT 90 

SETWRITE "D : SEPT2 

Everything in the septi file is printed on the screen. 

SETREAD "D : SEPT2 
REPEAT 4 [PR RL] 

FD 30 
RT 45 

SETWRITE [ ] 

SETREAD [ ] 

Everything in the SEPT2 file is printed on the screen. 
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Primitives 



There are some special primitives that may affect the Logo 
system itself. They give you the power of directly accessing the 
computer memory or modifying what's in it. At the same time 
they are dangerous primitives because you can destroy the 
contents of your workspace in Logo by using them carelessly. 

If that happens, you will need to restart Logo. The names of 
these primitives start with a dot to warn you that they are 
dangerous. You should save your work before experimenting 
with them. For further information see ATARI’S Technical 
Reference Notes. 


.call command 

.CALL n 

Tranfers control to the indicated machine language subroutine 
starting at address n (decimal). 


.deposit command 


.deposit n byte 

Writes byte into machine address n (decimal). 
EXAMPLES 

The following procedures change the size of the turtle. 
TO BIG 

.DEPOSIT 53256 1 
END 

TO SMALL 
.DEPOSIT 53256 0 
END 

TO BIGGER 
.DEPOSIT 53256 3 
END 
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Primitives 

.EXAMINE 

operation 

.EXAMINE A7 

Outputs the contents of machine address n (decimal). 

.PRIMITIVES 

command 

.PRIMITIVES 

Prints a list of all the Logo primitives. 


.SETSCR 

command 


.SETSCR n 

Sets the aspect ratio (the ratio of the size of a vertical turtle step 
to the size of a horizontal one) to n ( - 2 through 2). The screen 
is cleared. 

.SETSCR .5 makes each vertical turtle step half the length of a 
horizontal one. 

.SETSCR is intended to be used when “squares” turn out 
looking like rectangles on some particular screens. (An aspect 
ratio of .8 is correct for most screens.) 

pal systems will be set for .setscr i . 
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Error Messages 


OUT OF SPACE 

Your workspace is almost completely filled. It’s best to erase 
some procedures and names from your workspace. 

YOU DON'T SAY WHAT TO DO WITH OBJECT 
A Logo object was given without preceding it by a command. 

TOO MUCH INSIDE ( ) 'S 

Parentheses were incorrectly placed in a Logo instruction. For 
example, parentheses surround more than one Logo 
expression. 

NOT ENOUGH INPUTS TO PROCEDURE 
A procedure or primitive is being run that requires more inputs. 

UNEXPECTED ')' 

A closing parenthesis has no corresponding opening 
parenthesis. A closing parenthesis was found when an input 
was expected. 

I DON'T KNOW HOW TO PROCEDURE 

Logo has tried to execute procedure but can’t find its 

definition. 

PROCEDURE DIDN'T OUTPUT TO PROCEDURE 
A procedure or primitive that requires an input was not given 
one and was followed on the same line by another procedure 
or primitive. 

NUMBER TOO BIG 

98 

The result of an arithmetic operation is more than i E98 (10 ) or 

QQ 

less than ie -98 (10 ). 



158 


•J U II U U U u II iJ jj fj u if Ci f < V % f f g ®' ft g E g gj g 1/ f, g g § g g g g g g g g g g 


Appendix A 
Error 

Messages 

PRIMITIVE DOESN'T LIKE OBJECT AS INPUT 
An incorrect input was given to a primitive. 

WORD HAS NO VALUE 

A variable was used that was not given a value. 

PRIMITIVE IS A PRIMITIVE 
A primitive name was given as an input to to or edit. 

PROCEDURE IS ALREADY DEFINED 

The name given as an input to to or edit has already been 
used as a procedure name. 

OBJECT IS NOT TRUE OR FALSE 

An input was given to if, and, or, or not that was not a 
predicate (didn't output true or false). 

FILE NAME NOT FOUND 

The file name given as input to load or setread is nonexistent. 
I CAN'T OPEN DEVICE:FILENAME 

The input to save, load, setread or setwrite is incorrect. For 
example, the device was not specified. 

YOU'RE AT TOPLEVEL 

The command stop or output was used outside of a 
procedure. 

STOPPED ! 

The break key was pressed, interrupting whatever was 
running. 
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Special Keys 


*An asterisk (*) indicates an editing command which works both 
inside and outside of the editor. 


BREAK 

Aborts whatever Logo is doing. If editing, 
changes made in the edit buffer will be 
ignored. 

CTRL -+ 

Moves the cursor one position to the right. 

CTRL <- 

Moves the cursor one position to the left. 

CTRL T 

Moves the cursor up to the previous line. 

CTRL i 

Moves the cursor down to the next line. 

CTRL 1 

Makes Logo stop scrolling until CTRL i is 
typed again. 

CTRL A 

Moves the cursor to the beginning of the 
current line. 

CTRL CLEAR 

Deletes text from the cursor position to the 
end of the current line. 

CTRL DELETE 
BACKS 

Erases the character at the cursor 
position. 

‘CTRL E 

Moves the cursor to the end of the current 
line. 

CTRL F 

Devotes full screen to graphics. 

CTRL INSERT 

Opens a new line at the position of the 
cursor. 

CTRLS 

Split screen: top for graphics, bottom for 
text. 

CTRL T 

Devotes entire screen to text. 

CTRL V 

Scrolls screen to next page in editor. 

CTRL W 

Scrolls screen back to previous page in 
editor. 
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Keys 

CTRL X 

Moves the cursor to beginning of editor. 

*CTRL Y 

Inserts the contents of the delete buffer. 

CTRL Z 

Moves the cursor to end of editor. 

* DELETE BACKS 

Erases the character to the left of the cursor. 

ESC 

Completes editing and exits to top level. 

‘RETURN 

Completes the line and puts the cursor to 
the beginning of the next line. 

‘SHIFT DELETE 
BACKS 

Deletes text from the cursor position to the 
end of the current line. 

SHIFT INSERT 

Opens a new line at the position of the 
cursor. 

\ (Backslash) 

Tells Logo to interpret the character that 
follows it literally as a character, rather than 
keeping some special meaning it might 
have. You have to backslash [,],(,), + , - , 
*, /, =, <, >, and itself. 


Other special keys are listed in Getting Started. 
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Useful Tools 


The procedures collected here in alphabetical order are likely 
to be useful in constructing your own procedures. Examples of 
the use of some of these procedures appear in this manual 
(refer to the Index). The other procedures appear here for the 
first time. 

abs outputs the absolute value of its input. 

TO ABS : NUM 

OP IF : NUM < 0 [- : NUM] C : NUM ] 

END 

clear. demons clears all the when demons if given the input 
of 21 . (The Collision Detection Chart can be found on pg. 104.) 

TO CLEAR. DEMONS : DEMON 
IF : DEMON < 0 [STOP] 

WHEN : DEMON [ ] 

CLEAR. DEMONS : DEMON - 1 
END 

COPYDEF copies the definition of an “old” procedure name 
onto a “new” procedure name, copydef "sq "square would 
copy the definition of square onto the name SQ. Note that 
copydef uses define and text (page 169). 

TO COPYDEF : NEW :0LD 
MAKE "OLD TEXT :0LD 

DEFINE : NEW BF BF FIRST :OLD BF :0LD 
END 
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define makes a list the definition of the name you give as 
input. 

TO DEFINE : NAME :INPUT :LIST 

SETWRITE "D : PROG 

PR ( SE "TO : NAME :INPUT) 

PR. OUT : LIST 
PR "END 
SETWRITE [ ] 

LOAD "D : PROG 
ERF "D : PROG 
END 


e'- 

er 
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Useful Tools 


TO PR. OUT :LIST 
IF EMPTYP : LI ST [STOP] 

PR FIRST : LI ST 
PR. OUT BF : LI ST 
END 

DEFINE "SQUARE ":SIZE [[REPEAT 4 [ F D — ► 

: S I ZE RT 90]]] 

gives square this definition: 

TO SQUARE : S I ZE 

REPEAT 4 [FD :SIZE RT 90] 

END 

divisorp indicates whether its first input divides evenly into its 
second. 

TO DIVISORP : A :B 

OP 0 = REMAINDER :B :A 

END 

dot places a dot on the screen at the position given as input. 
Note that the turtle is left in the same state as before dot is run. 

TO DOT : POS 

ASK FIRST WHO [DOT1 POS :P0S PEN SHOW-*’ 

NP] 

END 

TO DOT1 rOLDPOS :POS :PEN :SHOWNP 
HT PU 

SETPOS : POS 
PD FD 0 PU 
SETPOS :OLDPOS 
RUN F PUT : PEN [ ] 

IF : SHOWNP [ST] 

END 

forever runs a list of instructions until the break key is 
pressed or the power is turned off. 

TO FOREVER : I NSTRU CT I ON L I ST 
RUN : INSTRUCTIONLIST 
FOREVER : INSTRUCTIONLIST 
END 
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init.turtle clears the screen of all the turtles, just leaving 
turtle 0 in the regular turtle shape. 

TO INIT.TURTLE 
TELL [0123] CS 
SETSH 0 HT 
TELL 0 ST 
END 

item outputs the :Nth element of a word or a list. 

TO ITEM : N lOBJECT 
IF EMPTYP rOBJECT [OP "] 

IF :N = 1 [OP FIRST : OBJ ECT] 

OP ITEM :N-1 BF :0BJ ECT 
END 

sort takes a list of words and outputs them alphabetically. 
supersort arranges them in a flat list. 

TO SORT : ARG :LIST 
IF EMPTYP :ARG [OP : LIST] 

MAKE "LIST INSERT FIRST : ARG :LIST 

OP SORT BF : ARG :LIST 

END 

TO INSERT : A :L 

IF EMPTYP : L [OP FPUT U LIST :A []] 

IF BEFORE : A FIRST BF :L [OP FPUT INS-> 

ERT : A FIRST :L BF :L] 

OP LPUT INSERT :A LAST :L BL :L 
END 

TO BEFORE :A :B 

IF OR EMPTYP : A EMPTYP :B [OP EMPTYP -» 

: A] 

IF NOT EQUALP FIRST :A FIRST :B [OP (-» 

ASCII : A ) < < ASCII :8 )] 

OP BEFORE BF :A BF :B 
END 

TO SUPERSORT :L 
IF EMPTYP : L [OP []] 

OP < SE SUPERSORT FIRST :L FIRST BF 
L SUPERSORT LAST :L ) 

END 
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Useful Tools 


Try this: 

MAKE "SORTLIST SORT [A D E F T C Z] -*■ 
[] 



PR SUPERSORT :SORTLIST 

A C D E F T Z 

Then type 




MAKE "SORTLIST SORT [FOO BAR BAZ] 
ORTLIST 

PR SUPERSORT :SORTLIST 

A BAR BAZ C D E F FOO T Z 


:S~* 




text outputs the definition of a procedure name, text 
"SQUARE could output [[TO SQUARE :SIZE] [REPEAT 4 [FD :SIZE 
RT 90]]] 

TO TEXT : NAME 
SETWRITE "D : PROG 
PO : N AME 
SETWRITE [ ] 

SETREAD "D : PROG 
OP REAOLINE LIST RL " 

ENO 

TO READLINE :TX 
MAKE "LINE RL 

IF [END] = : LINE [ERF "D:PROG OP :TX] 

OP READLINE LPUT : LINE :TX 
END 

which outputs which position an element has in its list, which 
"C [a b C] outputs 3. Complement to the procedure item. 

TO WHICH :MEMBER :LIST 
IF EMPTYP :LIST [OP 01 
IF :MEMBER = FIRST :LIST [OUTPUT 1] 

OUTPUT 1 + WHICH : MEMBER BF :LIST 
END 
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while repeats a group of instructions until :CONDiTiON 
becomes false. 

TO WHILE : CONDITION : INSTRUCTIONLIST 
IF NOT RUN : COND IT I ON [STOP] 

RUN : INSTRUCTIONLIST 

WHILE : CONDITION : INSTRUCTIONLIST 

END 
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Memory Space 


Logo procedures and variables take up space; more space is 
used when the procedures are run. 

Some Logo users may wish to know how space is used in 
Logo and how to conserve it. In general, saving space is not 
something you should worry about. Instead you should try to 
write procedures as clearly and elegantly as possible. 

However, we recognize that ATARI Logo has only a finite 
memory. This appendix discusses how space is allocated in 
Logo and how you can use less of it. 

How It Works 

Space in Logo is allocated in nodes, each of which is five bytes 
long. All Logo objects and procedures are built out of nodes. 
The internal workings of Logo also use nodes. The interpreter 
knows about certain free nodes that are available for use. 

When there are no more free nodes, a special part of Logo 
called the garbage collector looks through all the nodes and 
reclaims any nodes that are not being used. 

For example, during execution of the following statements 

MAKE "NUMBER 7 
MAKE "NUMBER 90 

after you say make "number 7, number is assigned to two 
nodes that hold the value 7. After executing make "number 90, 
the nodes containing the 7 can be reused, and they will be 
reclaimed as free nodes the next time the garbage collector 
runs. The garbage collector runs automatically when 
necessary, but you can make it run with the Logo command 
RECYCLE. 

The operation nodes outputs the number of free nodes; 
however, if you really want to find out how much space you 
have, you should do something like the following: 

RECYCLE PRINT NODES 

1259 
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Memory Space 

How Space Is Used 

Every Logo word used is stored only once: all occurrences of 
that word are actually pointers to the word. A word takes up 
two nodes, plus one node for every two letters in its name. 

A number, whether integer or decimal, takes up two nodes 
(exponent and mantissa). A list takes up one node for each 
element (plus the size of the element itself). 

Space Saving Hints 

1 . It is important to remember that it is bad form to save space 
by writing procedures that are less readable because of the 
use of short or obscure words. 

2. Rewrite the program. Use procedures to replace repetitive 
sections of the program. 

3. Space can be saved in Logo by not creating new words. 
The names of inputs of procedures can be the same as 
names of inputs of other procedures. The names of 
procedures and primitives can also be used as variable 
names. 

4. It should be noted that misspellings, typing errors, and 
words that are no longer being used are not destroyed. 
PRIMT "F00 

I DON'T KNOW HOW TO PRIMT 

KISS 

I DON'T KNOW HOW TO KISS 

The words primt, foo, and kiss will be created and will 
not go away. However, if a word has no value or 
procedure definition, it will not be written out to a file. So if 
you are running out of space and have a lot of these words 
(sometimes known as truly worthless atoms) you can write 
out your workspace to a file and then read it into a freshly 
started Logo. 
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When you type a line in Logo, it recognizes the characters as 
words and lists, and builds a list which is Logo’s internal 
representation of the line. This process is called parsing. This 
appendix will help you understand how lines are parsed. To 
see the parsing effect, type the line in a procedure definition 
with the command TO and use the Logo editor to see the result 

Delimiters 

A word is usually delimited by spaces. That is, there is a space 
before the word and a space after the word; they set the word 
off from the rest of line. There are a few other delimiting 
characters: 

NO =<> + -* /\ 

There is no need to type a space between a word and any of 
these characters. For example, to find out how this line is 
parsed: 

IF 1<2[PRINT(3+4)/5] [PRINT :X+6] 

Type 
TO TEST 

IF 1<2CPRINT(3+4)/5] [PRINT :X+6] 

ENO 

ED "TEST 

The screen will look like this: 

TO TEST 

IF 1 < 2 [PRINT ( 3 + 4 ) / 5] [PRINT-* 

: X + 6] 

END 

To treat any of the characters mentioned above as a normal 
alphabetic character, put a backslash " \ ” before it. For 
example: 

PRINT "SAN \ FRANCISCO 

SAN FRANCISCO 
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Infix Procedures 


The characters = are the names of infix 

procedures. They are treated as procedures with two inputs, 
but the name is written between the two inputs. 

Brackets and Parentheses 

Left bracket and right bracket “]” indicate the start and end 
of a list or sublist. 


Parentheses ( ) group things in ways Logo ordinarily would not, 
and vary the number of inputs for certain primitives. 


If the end of a Logo line is reached (that is, the return key is 
pressed) and brackets or parentheses are still open, all sublists 
or expressions are closed. For example: 


REPEAT 4 

THIS CIS 
THIS CIS 
THIS [IS 
THIS [IS 


[PRINT [THIS [IS [A [TEST 

[A [TEST]]] 

[A [TEST]]] 

[A [TEST]]] 

[A [TEST]]] 


If a right bracket is found for which there was no 
corresponding left bracket, Logo stops execution of the rest of 
the line or procedure. For example: 

] PR I NT "ABC 

Logo prints an empty line. 


Quotes and Delimiters 

Normally, you have to put a backslash before the characters [, 
].(.). + , - , / , = , < , > , and \ itself. But the first 

character after a quote (") does not need to have a backslash 
preceding it. For example: 

print '•* 

* 

If a delimiter is occupying any position but the first after the 
quote, it must have a backslash preceding it. For example: 
print '•**** 

NOT ENOUGH INPUTS TO * 
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The only exception to the above general rule is [ ] (brackets). 
You must always precede a bracket that is being quoted by the 
backslash. 

PRINT "[ 

YOU DON'T SAY WHAT TO DO WITH [ 3 

PRINT "\[ 

C 


The Minus Sign 

The way in which the minus sign “ - ” is parsed is an unusual 
case. The problem here is that one character is used to 
represent three different things: 

1 . Part of a number to indicate that it is negative, as in - 3. 

2. A procedure of one input, called unary minus, which 
outputs the additive inverse of its input, as in - xcor or 
- DISTANCE. 

3. A procedure of two inputs, which outputs the difference 
between its first input and its second, as in 7 - 3 and 
XCOR - YCOR. 


The parser tries to be clever about this potential ambiguity and 
figure out which one was meant by the following rules: 


1 |f the “ - ” immediately precedes a number, and follows 
any delimiter (including a space) except right parenthesis 
“)”, the number is parsed as a negative number. This 
allows the following behavior: 
print 3 * - 1 (parses as 3 times negative 1 ) 
print 3 * - 4 (parses as 3 times negative 4) 

FIRST [- 3 4] (OUtpUtS -1) 

FIRST [-34] (OUtpUtS - 3) 
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Parsing 

2. If “ — ” is preceded by a numeric expression, it works like 
an infix 

PR 3-4 is -1 
PR XCOR - YCOR 

3. If “ - ” is not preceded by a numeric expression, it works 
like a unary minus. 

PR -XCOR 
PR -(3 + 4) 
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ASCII Code 


DECIMAL 

CODE 

CODE 

CHARACTER 

DECIMAL 

CODE 

CODE 

CHARACTER 

0 

□ 

15 

a 

1 

o 

16 

Q 

2 

n 

17 

D 

3 

a 

18 

Q 

4 

a 

19 

a 

5 

a 

20 

□ 

6 

a 

21 

B 

7 

a 

22 

n 

8 
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23 
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24 

a 

10 

a 

25 

a 

11 

B 

26 

c 

12 

a 

27 
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o 

14 

B 

29 
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ASCII Code 


DECIMAL 

CODE 

CODE 

CHARACTER 

DECIMAL 

CODE 

CODE 

CHARACTER 

30 

Q 

45 

B 

31 

O 

46 

a 

32 

Space 

47 

0 

33 

a 

48 

□ 

34 

a 

49 

a 

35 

0 

50 

□ 

36 

0 

51 

e 

37 


52 

□ 

38 

□ 

53 

D 

39 

a 

54 

□ 

40 

a 

55 

a 

41 

0 

56 

□ 

42 

0 

57 

□ 

43 

a 

58 

a 

44 

0 

59 

D 
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Sr 

F 

F 

F 
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DECIMAL 

CODE 

DECIMAL 

CODE 

F 

CODE 

CHARACTER 

CODE 

CHARACTER 

F 





F 





F 

60 

Q 

75 

Q 

F 

F 

61 

e 

76 

G 

F 

F 
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62 
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78 
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DECIMAL 

CODE 

CODE 

CHARACTER 

DECIMAL 

CODE 

CODE 

CHARACTER 






id 





«S 

90 

□ 

105 

o 

«§ 

«» 

91 

o 

106 

o 

«* 

92 

a 

107 

□ 

wi 

9 

93 

o 

108 

o 

oi 

tsS» 

94 

a 

109 

Q 

9 

9 

95 

B 

110 

a 

9 

96 

□ 

111 

□ 

9 

9 

97 

a 

112 

a 

9 





9 

9 

98 

□ 

113 

□ 

9 

99 

a 

114 

o 

9 





9 

100 

□ 

115 

□ 

vw 
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□ 

116 
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a 

117 

a 

53 

S3 
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□ 
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9 

9 

104 

a 

119 
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DECIMAL 

CODE 

CODE 

CHARACTER 

DECIMAL 

CODE 

CODE 

CHARACTER 

120 

□ 

135 

H 

121 

□ 

136 

H 

122 

a 

137 

□ 

123 

□ 

138 

E 

124 

a 

139 

□ 

125 

□ 

140 

□ 

126 

□ 

141 

□ 

127 

D 

142 

□ 

128 

0 

143 

□ 

129 

m 

144 

0 

130 

□ 

145 

s 

131 

s 

146 

s 

132 

0 

147 

0 

133 

0 

148 

0 

134 

0 

149 
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G 



186 


f}finnnnfinnnnr\n*\nr)f\*\*) 



5 

5 > 


Appendix F 


ASCII Code 


DECIMAL 

CODE 

CODE 

CHARACTER 

DECIMAL 

CODE 

CODE 

CHARACTER 

150 

0 

165 

% 

151 

0 

166 

0 

152 

0 

167 

□ 

153 

E 

168 

0 

154 

0 

169 

0 

155 

(EOL) 

170 

E] 

156 

0 

171 

□ 

157 

0 

172 

□ 

158 

0 

173 

E 

159 

0 

174 

□ 

160 

J Space 

175 

□ 

161 

□ 

176 

0 

162 

□ 

177 

0 

163 

0 

178 

0 

164 

0 

179 

0 
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DECIMAL CODE 

CODE CHARACTER 


DECIMAL CODE 

CODE CHARACTER 


180 

0 

195 

c 

181 

0 

196 

D 

182 

0 

197 

0 

183 

0 

198 

0 

184 

0 

199 

0 

185 

0 

200 

0 

186 

□ 

201 

0 

187 

0 

202 

0 

188 

□ 

203 

0 

189 

0 

204 

0 

190 

0 

205 

0 

191 

0 

206 

N 

192 

0 

207 

0 

193 

A 

208 

0 

194 

B 

209 

0 
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DECIMAL 

CODE 

CODE 

CHARACTER 

DECIMAL 

CODE 

CODE 

CHARACTER 

210 

0 

225 

0 

211 

0 

226 

0 

212 

0 

227 

0 

213 

0 

228 

0 

214 

0 

229 

0 

215 

0 

230 

0 

216 

0 

231 

0 

217 

0 

232 

0 

218 

0 

233 

0 

219 

□ 

234 

0 

220 

□ 

235 

0 

221 

0 

236 

0 

222 

□ 

237 

0 

223 

□ 

238 

0 

224 

0 

239 

0 
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CODE 

CHARACTER 

decimal 

CODE 

Ir 

cr 

decimal 

CODE 

CODE 

CHARACTER 

CF 
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240 

0 

248 

Gr 

Gr 

241 

0 

249 

0 

Cr 

c 

242 

□ 

250 

0 

cr 

«r 

243 

0 

251 

0 

CT 

CT 

244 

0 

252 

0 

cr 

245 

0 

253 

0 

cr 

cr 

246 

0 

254 

0 

<r 

cr 

247 

0 

255 

E 

cr 

cr 


cr 

cr 

c 

£ 

cr 

CT 

£ 

ASCII* CODE 

The white characters in black squares represent normal video C 
characters. Black characters in white squares represent C 

reverse video characters. w 


*For the special characters found on the ATARI Computer, an 
extended version of ASCII code is used. 
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Turtle 

SHAPE 

Arithmetic 

Graphics 

SHOWNP 

Operations 

ASK 

SPEED 

COS 

BACK, BK 

ST 

INT 

BG 

TELL 

PRODUCT 

CLEAN 

WHO 

RANDOM 

COLOR 

WINDOW 

REMAINDER 

CS 

WRAP 

RERANDOM 

EACH 

XCOR 

ROUND 

EDSH 

YCOR 

SIN 

FORWARD, FD 

Words 

SORT 

GETSH 

and Lists 

SUM 

HEADING 

ASCII 

a + b 

HOME 

BUTFIRST, BF 

a - b 

HT 

BUTLAST, BL 

a * b 

LEFT, LT 

CHAR 

alb 

PC 

COUNT 

a < b 

PE 

EMPTYP 

a = b 

PEN 

EQUALP 

a > b 

PENDOWN, PD 

FIRST 

Defining 

PENUP, PU 

FPUT 

and Editing 

PN 

LAST 

Procedures 

POS 

LIST 

EDIT, ED 

PUTSH 

LISTP 

EDNS 

PX 

LPUT 

END 

RIGHT, RT 

MEMBERP 

TO 

SETBG 

NUMBERP 

Flow of Control 

SETC 

SE 

and Conditionals 

SETH 

SETPC 

WORD 

COND 

WORDP 

IF 

SETPN 

SETPOS 

objl = obj2 

OUTPUT, OP 
OVER 

SETSH 

Variables 

REPEAT 

SETSP 

MAKE 

RUN 

SETX 

NAMEP 

STOP 

SETY 

THING 
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TOUCHING 

NODES 

WAIT 

PO 

WHEN 

POALL 

WHEN N 

POD 

Logical 

PODS 

Operations 

PONS 

POPS 

AND 

FALSE 

POTS 


RECYCLE 

NUI 

OR 

Files 

TRUE 

CATALOG 

The Outside 

ERF 

World 

LOAD 

CT 

SAVE 

FS 

SETREAD 

JOY 

SETREAD [ ] 

JOYB 

SETWRITE 

KEYP 

SETWRITE [ 1 

PADDLE 

Special 

PADDLEB 

Primitives 

PRINT, PR 

.CALL 

RC 

.DEPOSIT 

RL 

.EXAMINE 

SETCURSOR 

.PRIMITIVES 

SETENV 

.SETSCR 

SHOW 

SS 

TOOT 

Special 

Keys 

BREAK 

TS 

CTRL -»• 

TYPE 

Workspace 

CTRL <~ 
CTRL t 

Management 

CTRL i 

ERALL 

CTRL 1 

ERASE, ER 

CTRL A 

ERN 

CTRL CLEAR 

ERNS 

CTRL DELETE BACK S 

ERPS 

CTRLE 


Logo Vocabulary 


CTRL F 
CTRL INSERT 
CTRLS 
CTRL T 
CTRL V 
CTRL W 
CTRL X 
CTRLY 
CTRL Z 

DELETE BACK S 
ESC 

RETURN 

SHIFT DELETE BACK S 
SHIFT INSERT 
\ (Backslash) 


Note: See glossary 
for definitions and 
required inputs. 
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Note: A number sign (#) indicates a procedure which can 
take any number of inputs; if you give it other than the 
number indicated, you must enclose the entire expression in 
parentheses. An asterisk (*) indicates an editing command 
which works inside and outside of the editor. For definitions of 


Input Words see page 21 . 
*and predl pred2 

ascii char 

ask turtlenumber list 

back, bk distance 

BG 

BUTFIRST, BF obj 
BUTLAST, BL obj 
.CALL n 

catalog device: 

CHAR n 
CLEAN 


Outputs true if all its inputs are 
TRUE. 

Outputs ASCII code for char. 

Asks the turtlenumber(s) to run 
the instructions in list. 

Moves turtle distance steps 
back. 

Outputs number representing 
background color. 

Outputs all but first element of 
obj. 

Outputs all but last element of 
obj. 

Transfers control to a machine 
language subroutine starting at 
address n (decimal). 

Displays names of all files on 
diskette. On cassette, prints 
definitions of procedures and 
names in the file. 

Outputs character whose ASCII 
code is n. 

Erases graphics screen without 
affecting turtle’s state. 
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Glossary 

COLOR 

Outputs number representing 
the turtle color. 

cond condnumber 

Outputs true if condition 
condnumber is occurring. 

cos n 

Outputs cosine of n degrees. 

COUNT obj 

Outputs the number of 
elements in obj. 

cs 

Erases screen, moves turtle to 
the position [0 0], Sets heading 
to 0. 

CT 

Clears text screen. 

.deposit n byte 

Writes byte into address n 
(decimal). 

EACH list 

Makes each turtle separately 
run the commands in list. 

EDIT, ED name(s) 

Starts Logo editor with named 
procedure(s). 

EDNS 

Starts Logo editor with all 
variables in the workspace. 

edsh shapenumber 

Starts the Logo shape editor, 
displaying the shape 
shapenumber. 

EMPTYP Obj 

Outputs true if obj is empty. 

END 

Ends the procedure definition 
started out by to. 

EQUALP Objl Obj 2 

Outputs true if its inputs are 
equal. 

ERALL 

Erases everything from the 
workspace. 

erase, er name(s) 

Erases all named procedure(s). 
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erf device:filename 

Erases filename from device. 

ern name(s) 

Erases all named variables. 

ERNS 

Erases variables from the 
workspace. 

ERPS 

Erases all procedures from the 
workspace. 

.EXAMINE n 

Outputs contents of address n 
(decimal). 

FALSE 

Special input for and, if, not 
and or. 

FIRST Obj 

Outputs first element of obj. 

forward, fd distance 

Moves turtle distance steps 
forward. 

FPUT Obj list 

Outputs list formed by putting 
obj on front of list. 

FS (CTRL F) 

Devotes entire screen to 
graphics. 

Getsh shapenumber 

Returns a list of 16 numbers; 
these numbers correspond to 
bits in the shape. 

HEADING 

Outputs turtle’s heading. 

HOME 

Moves turtle to [0 0] and sets 
heading to 0. 

HT 

Makes turtle invisible. 

IF p red list 1 (Iist2) 

If pred is true, runs listl, 
otherwise Iist2. 

int n 

Outputs the integer portion of n. 
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joy joystickn umber 

Outputs current position of 
joysticknumber. 

joyb joysticknumber 

Outputs true if the button on 
joysticknumber is pressed. 

KEYP 

Outputs true if a key has been 
typed but not yet read. 

LAST Obj 

Outputs last element of obj. 

left, lt degrees 

Turns turtle degrees left 
(counter-clockwise). 

list objl obj2 

Outputs list of its inputs. 

LISTP Obj 

Outputs true if obj is a list. 

load device:filename 

Loads file called filename from 
device into the computer. 

lput obj list 

Outputs list formed by putting 
obj on end of list. 

make name obj 

Makes name refer to obj. 

MEMBERP obj list 

Outputs true if obj is included 
in list. 

namep name 

Outputs true if name has a 
value. 

NODES 

Outputs number of free nodes. 

not pred 

Outputs true if pred is false. 

NUMBERP Obj 

Outputs true if obj is a 
number. 

#or predl pred 2 

Outputs true if any of its 
inputs are true. 

OUTPUT, OP obj 

Returns control to caller, with 
obj as output. 
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4- 

4-j 

□ 

l 

over turtlenumber 

Outputs number symbolizing 


pennumber 

collision between turtlenumber 


and pennumber. 

a 

paddle paddlenumber 

Outputs rotation on dial of 



paddlenumber. 

r- 

paddleb paddlenumber 

Outputs true if the button is 

c~-- 


pressed on paddlenumber. 

r~ 

pc pennumber 

Outputs number representing 

r 

pen color of pennumber. 

r 

PE 

Puts pen eraser down. 

r- 

PEN 

Outputs pen state (pd, pu, pe 

r 


or PX). 

r 

PENDOWN, PD 

Puts turtle’s pen down. 

r 

PENUP, PU 

Raises turtle’s pen. 

r 

PN 

Outputs the pen number (0, 1 

r 


or 2) being used. 

¥ 

po name(s) 

Prints definitions of named 

w 


procedures. 


POALL 

Prints definitions of procedures 

r 


and names (variables). 

r 

pod condnumber 

Prints when demon 



condnumber currently in 

r 


action. 


PODS 

Print out all active when 

t' 


demons. 

r 

PONS 

Prints names and values of all 

£T" 


variables. 

t 

POPS 

Prints definitions of all 



procedures. 

'Ll 
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POS 

Outputs coordinates of turtle’s 
position. 

POTS 

Prints title lines of procedures. 

.PRIMITIVES 

Prints the list of Logo 
primitives. 

# PRINT, PR Obj 

Prints obj followed by carriage 
return (strips off outer brackets 
of lists). 

If product a b 

Outputs product of its inputs. 

putsh shapenumber 
shapespec 

Gives shapenumber the 
form of shapespec, the grid of 
bits. 

PX 

Puts reversing pen down. 

RANDOM n 

Outputs random integer 
between 0 and n - 1 . 

RC 

Outputs character read by the 
current device (default is 
keyboard). Waits if necessary. 

RECYCLE 

Performs a garbage collection. 

REMAINDER a b 

Outputs remainder of a divided 
by b. 

REPEAT n list 

Runs list n times. 

RERANDOM 

Makes random behave 
reproducibly. 

right, rt degrees 

Turns turtle degrees right 
(clockwise). 

RL 

Outputs line read by current 
device (default is keyboard). 
Waits if necessary. 
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ROUND n 

RUN list 

save device:filename 

#se objl obj2 
setbg colornumber 

setc colornumber 

SETCURSOR pOS 

setenv voice duration 

seth degrees 

setpc pennumber 
colornumber 

setpn pennumber 

setpos position 
setread device-filename 

SETREAD [ ] 

.SETSCR n 

setsh shapenumber 


Outputs n rounded off to 
nearest integer. 

Runs list, outputs what list 
outputs. 

Saves workspace onto the 
device. 

Outputs list of its inputs. 

Sets background to 
colornumber. 

Sets the turtle’s colornumber. 

Puts cursor at pos. 

Sets envelope of voice for 
toot so volume reduces by 
one unit every duration. 

Sets turtle’s heading to 
degrees. 

Sets pennumber (0, 1 or 2) to 
colornumber. 

Sets the pen to pennumber (0, 

1 or 2). 

Moves turtle to position. 

Sets the device filename from 
which the output of rc and RL 
will be read. 

Closes the file that was opened 
with SETREAD. 

Sets aspect ratio to n. 

Sets shape of turtle to 
shapenumber. 
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setsp speed 

Sets the turtle’s speed. 

setwrite device:filename 

Starts the process of sending a 
copy of all the characters 
displayed on the screen to 
device:filename. 

SETWRITE [ ] 

Closes the file that was opened 
with setwrite . 

SETXX 

Moves turtle horizontally to 
x-coordinate at x. 

SETY y 

Moves turtle vertically to 
y-coordinate at y. 

SHAPE 

Outputs number representing 
shape of the current turtle. 

SHOW obj 

Prints obj followed by return 
with brackets for list. 

SHOWNP 

Outputs true if turtle is shown. 

sin n 

Outputs sine of n degrees. 

SPEED 

Outputs current turtle's speed. 

SORT n 

Outputs square root of n. 

SS (CTRL S) 

Splits screen: top for graphics, 
bottom for text. 

ST 

Makes the turtle(s) visible. 

STOP 

Stops procedure and returns 
control to caller. 

sum a b 

Outputs sum of its inputs. 

tell turtlenumber(s) 

Addresses all following 
commands to turtlenumber(s). 

thing name 

Outputs object referred to by 
name. 
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w 

fr 

& 

& 

F 


to name (inputs) 

Begins defining procedure 

F 


name. 

F 

toot voice freq 

Produces sound on voice of 

F 

volume duration 

frequency freq and volume for 

F~~ 


duration. 

F' 

touching turtlenumberl 

Outputs number symbolizing 

F' 

turtlenumber2 

collision between 

F 


turtlenumberl and 

F 


turtlenumber2. 

F~ 

TRUE 

Special input for and, if, not 

F 


and or. 

F 

c- 

TS (CTRL T) 

Devotes entire screen to text. 

tf 

F 

#TYPE Obj 

Prints obj leaving the cursor at 

F 


the end of the printed line. 

F 

WAIT n 

Pauses for n 60ths of a 

F 


second. 

F 

when condnumber list 

Sets up when demon so 

F 


whenever condition 

r 


condnumber occurs, list is run. 

F 

i ■ 

when condnumber [ 1 

Clears (stops) when demon for 

r 


condnumber. 

$- 

WHO 

Outputs number of current 

r 


turtle. 

F 

WINDOW 

Makes graphics screen a 

F 


window of an expanded turtle 

F 


field. Clears screen. 

F 

# word wordl word 2 

Outputs word made up of its 

F 


inputs. 

F 

WORDP obj 

Outputs true if obj is a word. 

F 

F 


ta 

F ' 

tJ 

* I 

r; 
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WRAP 

Makes turtle field wrap around 

iito 


edges of screen. Clears 



screen. 

uJ 

XCOR 

Outputs x-coordinate of turtle’s 

{2 


position. 


YCOR 

Outputs y-coordinate of turtle’s 

(2 


position. 

2 

a + b 

Outputs a plus b. 


a - b 

Outputs a minus b. 

\ r 

a * b 

Outputs a times b. 

« 

alb 

Outputs a divided by b. 

y'S 

a < b 

Outputs true if a is less than b. 

2 

a > b 

Outputs true if a is greater 

v2 


than b. 


objl = obj2 

Outputs true if objl is equal to 

w 

v5 


obj2. 

•> 

V\~v 

Special Keys 



ATARI Key (A) 

After this key is pressed, all 

s 

REVERSE VIDEO KEY(B) 

characters typed appear in 
reverse video on the screen. 


‘BREAK 

Aborts whatever Logo is doing. 



If editing, changes made in the 

w 


edit buffer will be ignored. 

Z2 

‘CTRL -► 

Moves the cursor one position 

Z3 


to the right. 

w 

‘CTRL <- 

Moves the cursor one position 

Mt* 

*5 


to the left. 

* 

•9 


205 







% 



F- 
g ^ 

CTRL T 

Moves the cursor up to the 


previous line. 

t 

CTRL 1 

Moves the cursor down to the 

F 


next line. 

w 

CTRL 1 

Makes Logo stop scrolling until 

F- 

g 

CTRL i is typed again. 

F 

CTRL A 

Moves the cursor to the 

F 

beginning of the current line. 

F 

‘CTRL CLEAR 

Deletes text from the cursor 

F - 

position to the end of the 

F 


current line. 

F 

*CTRL DELETE BACK S 

Erases the character at the 

F 

cursor position. 

F 

*CTRLE 

Moves the cursor to the end of 
the current line. 

F 

F 


F 

CTRL F 

Devotes full screen to graphics. 

F 

CTRL INSERT 

Opens a new line at the 



position of the cursor. 

F 

CTRLS 

Split screen: top for graphics, 

F 

bottom for text. 

t 

CTRL T 

Devotes entire screen to text. 

F 

F 

CTRL V 

Scrolls screen to next page in 

F 

editor. 

F ' 

CTRL W 

Scrolls screen back to previous 

F 

page in editor. 

F,1 

CTRL X 

Moves the cursor to beginning 

* 

of editor. 

* 

*CTRL Y 

In the editor, CTRL Y inserts the 
contents of the delete buffer . 

* 

F 


Outside the editor, inserts the 



last command line typed. 

i 
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CTRL Z 

Moves the cursor to end of 
editor. 

* DELETE BACK S 

Erases the character to the left 
of the cursor. 

ESC 

Completes editing and exits to 
top level. 

Fl, F2, F3, F4 

Cursor control keys that can be 
programmed. 

‘RETURN 

Completes the line and puts 
the cursor to the beginning of 
the next line. 

‘SHIFT DELETE BACK S 

Deletes text from the cursor 
position to the end of the 
current line. 

SHIFT INSERT 

Opens a new line at the 
position of the cursor. 

SYSTEM RESET 

Reboots Logo, erasing the 
memory space. 

\ (Backslash) 

Tells Logo to interpret the 
character that follows it literally 
as a character , rather than 
keeping some special meaning 
it might have. You have to 
backslash [,],(,), + , - , *, / , 
= , < , > , and itself. 
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Index 


Index 


★ 

87 

c 


+ 

85 

CALCULATOR 

110 


86 

.CALL 

154 

— ► 

17, 93 

CAPITAL 

75 

/ 

88 

caps lowr key 

7 

\ 

52 

CATALOG 

146, 147 

. 

10, 13 

CHANGEBG 

38 

< 

88 

CHANGESH 

36 


71, 89 

CHAR 

58 

> 

89 

character 

21 

[ 

] 

A 

10,177 

CHECK 

121 

10, 177 

CLEAN 

27 


CLEAR. DEMONS 

166 

ABS 

87, 166 

CODE 

55 

addition 

85 

Collision Detection 

104 

AND 

121 

colon (:) 

10, 13 

ANNOUNCE 

69 

COLOR 

27 

ASCII 

55 

color, background 

26 

ASK 

25 

colornumber 

21 

aspect ratio 

155 

color, pen 

34 

ATARI key (A) 

6, 49 

COME.AND.GO 

9 

B 


command 

12 

BACK, BK 

25 

COMMENT 

57 

backslash, \ 

52, 176, 178 

COND 

105 

BEFORE 

168 

conditionals 

102 

BETWEEN 

89 

condnumber 

21 

bg, background color 26 

COPYDEF 

166 

BIG 

154 

COS 

79 

BIGGER 

154 

COUNT 

59 

BIGWELCOME 

10, 15 

COUNTDOWN 

112 

brackets, [ ] 

10, 177 

CS (clearscreen) 

27 

break key 

6, 49, 96, 99 

CT (cleartext) 

126 

buffer 

93 

Ctrl key 

5 

BUTFIRST, BF 

56 

CTRL 1 

95 

BUTLAST, BL 

57 

CTRL *- 

6, 49, 94 

byte 

21 

CTRL -*■ 
CTRL t 

6, 49, 94 
6,49,94 
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CTRL i 

6, 49, 94 

E 


CTRL CLEAR 

95 

EACH 

28 

CTRL DELETE BACK S 

95 

EASTWARD 

41 

CTRL INSERT 

95 

EDIT, ED 

97 

CTRL A 

94 

edit buffer 

93 

CTRLE 

94 

EDNS 

98 

CTRL F 

127 

EDSH 

29,48 

CTRLS 

133 

element 

52 

CTRL T 

134 

empty list 

53 

CTRL V 

95 

empty word 

53 

CTRL W 

95 

EMPTYP 

60 

CTRL X 

94 

END 

98 

CTRLY 

95 

EQUALP 

61 

CTRL Z 

94 

equals sign ( = ) 

71,89 

cursor 

4 

ERALL 

138 

cursor motion 

49, 94 

ERASE, ER 

138 

D 


ERF 

147 

D6 

81 

ERN 

16, 139 

DECIDE 

107 

ERNS 

139 

decimal number 

78 

ERPS 

139 

DECIMALP 

121 

error message 

158 

DEFINE 

166 

ESC key 

6, 49, 96, 97 

degrees 

21 

EVENP 

82 

DELETE BACK S key 

6, 95 

EVENT 

104 

delete buffer 

93 

.EXAMINE 

155 

delimiter 

176 

exponent 

78 

device 

21 

exponential form 

78 

DEMONS. TASK 

116 

EYES 

150 

.DEPOSIT 

154 



difference 

86 

F 


diskette 4, 

146, 147 

FI, F2, F3, F4 

49 

distance 

21 

FACTORIAL 

87 

DISTANCE 

84 

FALSE 

122 

division sign (/) 

88 

field 

35, 40, 42 

DIVISORP 

167 

filename 

21 

DOT 

167 

files 

146 

DOT 1 

167 

FIND. THEM 

117 

DRIVE 

129, 130 

FIRST 

62 

duration 21,132,134 

FLIP 

13 


flow of control 

102 

K 


FOREVER 112, 167 

KEYP 

128 

FORWARD, FD 

29 

L 


FPUT 

63 

LAST 

63 

frequency, freq 

21, 134 

LATIN 

70 

FROM. HOME 

84 

LEFT, LT 

33 

FS (CTRL F) 

126 

less than sign (<) 

88 

G 


literal word 

11 

garbage collection 

143 

LIST 

64 

garbage collector 

143 

list 1 1 1 21 , Od 

GET.USER 

131 

LISTP 

on 

GETSH 

30 

LOAD 

148 

global variable 

15 

local variable 

15 

greater than sign (>) 

89 

logical operation 

120 

GREET 

99 

logo line 

16 

H 


logo object 

20 

halting 

102 

LOWERCASE 

58 

HEADING 

32 

LPUT 

66 

HALT. AT 

44 

M 


HOME 

32 

MAKE 

14, 74 

home position 

25, 32 

MAP 

111 

ht (hideturtle) 

33 

MARK. TWAIN 

108 

1 


MEMBERP 

67 

IF 

106 

minus sign (-) 

86, 178 

INC 

76 

MOUNTAINS 

124 

INIT.TURTLE 

168 

MOVE 

135 

infix procedures 

177 

multiplication sign (*) 

87 


inputs 

INSERT 

instructionlist 

int (integer) 

integer portion 

INTP 

ITEM 

J 

JOY 

JOYB 

JOYH 

joysticknumber 


9, 21, 74 
168 
21 
79 

79 

80 

59, 108, 168 


127 

127 

115 

21 


name 

namelist 

NAMEP 

negative numbers 

NEWENTRY 

NODES 

NOT 

NUMBERP 


& 

C 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

F 

f: 

F 


15, 21 
21 
75 
86 
66 
139 


1 


& 

F 

r 

F' 


I 


F 


F 


* 

122 -J 


68 
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PRINTMESSAGE 

93 

object 

22 

printer 

146, 149 

operation 

12 

procedures 

8 

OR 

123 

PRODUCT 

80, 87 

OUTPUT, OP 

107 

prompt 

4 

OVER 

103, 109 

PROMPT 

135 

P 


PR. OUT 

167 

PADDLE 

128 

PUTSH 

35 

PADDLEB 

129 

px (pen reverse) 

37 

paddlenumber 

22 

Q 


parentheses ( ) 

177 

quotes 

10, 177 

pc (pencolor) 

34 

R 


PDRAW 

128 

RANDOM 

81 

pe (penerase) 

34 

random number 

81, 82 

PEN 

34 

RANK 

61 

PENDOWN, PD 

34 

RANPICK 

59 

pennumber 

22, 34 

rc (readchar) 

130 

PENUP, PU 

34 

READLINE 

169 

PIG 

70 

REALWORDP 

123 

PLAY 

116 

recursion 

102 

plus sign ( + ) 

85 

RECYCLE 

143 

pn (pennumber) 

35 

REMAINDER 

81 

PO 

140 

REPEAT 

109 

POALL 

140 

repetition 

102 

POD 

141 

REPLACE 

36 

PODS 

141 

REPRINT 

130 

POLY 

92, 110 

RERANDOM 

82 

PONS 

16, 142 

return key 

5,95 

POPS 

142 

REV 

63 

POS 

35 

REVERSE VIDEO key (E)6, 49 

position, pos 

22 

RIGHT, RT 

37 

POSITIVE 

107 

rl (readlist) 

131 

POTS 

143 

root 

84 

pred, predicate 

22, 108,120 

ROUND 

83 

.PRIMITIVES 

155 

RUN 

110 

primitive 

8 



PRINT, PR 

9, 129 



PRINTBACK 

64 




s 


SAVE " D: 

148 

SAVE "P: 

148 

scientific notation 

78 

screen 126, 1 33, 134 

scrolling 

95 

SE 

68 

SECRETCODE 

55 

SETBG 

38 

SETC 

38 

SETCURSOR 

131 

SETENV 

132 

seth (setheading) 

38 

SETPC 

39 

SETPN 

40 

SETPOS 

40 

SETREAD 

149 

SETREAD [ ] 

146, 149 

.SETSCR 

155 

SETSH 

41 

SETSP 

41 

SETUP 

29, 106, 116 

SETWRITE 

146, 150 

SETWRITE [ ] 

150 

SETX 

42 

SETY 

42 

SHAPE 

43 

shapenumber 

22 

shapespec 

22 

shift key 

5 

SHIFT CAPS LOWR 

7 

SHIFT DELETE BACK S key 95 

SHIFT INSERT 

95 

SHOOT 

105 

SHOW 

133 

SHOWNP 

43 

SIN 

83 

SINE 

48 


SLOWFD 

113 

z i 

SMALL 

154 

1 

SORT 

168 

* 

SOUND. RANGE 

134 

p 

& m 

space 

173 

SPACE BAR 

5, 49 

SPEED 

43 


SPI 

SPRING 

141 

116 

r! 

sort (square root) 

84 

! 

SQUARE 

99, 1 1 1 

SS (CTRL S) 

133 

* 

?i 

i 

*■ 

r 

ST (showturtle) 

44 

STEER 

128 

STOP 

102, 112 

SUBMOUNTAIN 

124 

subprocedure 

9 

SUBSET 

108 

subtraction 

86 

SUFFIX 

70 

SUM 

85 

superprocedure 

9 

SUPERSORT 

168 

* 1 

SYSTEM RESET key 

7 

* 

T 



TALK 

60 


tan, tangent 

79 

C i 

TELL 

44 

- 1 

TEST 

176 

* i 

TEXT 

169 

*_ 

THING 

76 

i j 

TIMEOUT 

132 

3 

title line 

8 

* 

TO 

TONEO 

99 

132 

% 

% 

TONE1 

132 

TOOT 

134 

n 

TOUCHING 

103, 113 

\ 
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TRIANGLE 

56 

X 


trigonometry 

78, 79 

x-y coordinates 

35,42 

TRUE 

124 

XCOR 

47 

TS (CTRL T) 

134 

Y 


TURN 

128 

YCOR 

47 

turtle field 

35, 46, 47 



turtlenumber 

22 

a + b 

85 

turtle shape editor 

48 

a - b 

86 

TYPE 

135 

a * b 

87 

V 


a / b 

88 

value 

11, 74 

a < b 

88 

variable 

10, 13, 74 

a > b 

89 

voice 

22 

a = b 

89 

volume 

22 



VOWELP 

67 



W 




WAIT 

113 



WATCH 

117 



WELCOME 

8 



WHEN 

102, 114 



WHEN [ ] 

114 



WHICH 

169 



WHILE 

111, 170 



WHO 

45 



WINDOW 

46 



WORD 

69 



word 

1 1 , 22, 52 



word delimiter 

52 



WORD? 

122 



WORDP 

70 



workspace 

138 



WRAP 

47 
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Notes 



Every effort has been made to 
ensure the accuracy of the pro- 
duct documentation in this 
manual. However, because we 
are constantly improving and 
updating our computer software 
and documentation, Logo Com- 
puter Systems, Inc. is unable 
to guarantee the accuracy of 
printed material after the date of 
publication and disclaims liabili- 
ty for changes, errors or 
omissions. 

No reproduction of this docu- 
ment or any portion of its con- 
tents is allowed without the 
specific written permission of 
Logo Computer Systems, Inc. 

© 1983 Logo Computer 
Systems, Inc. 

All rights reserved. 


IjFlljFj 

Logo Computer 
Systems, Inc. 

9960 Cote de Liesse 
Lachine, Quebec 
Canada H8T 1A1 




